Deployments - Get
Obtém uma implantação.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version=2025-04-01Parâmetros de URI
| Nome | Em | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
deployment
|
path | True |
string minLength: 1maxLength: 64 pattern: ^[-\w\._\(\)]+$ |
O nome da implementação. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 pattern: ^[-\w\._\(\)]+$ |
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas. |
|
subscription
|
path | True |
string |
A ID da assinatura do Microsoft Azure. |
|
api-version
|
query | True |
string |
A versão da API a ser usada para esta operação. |
Respostas
| Nome | Tipo | Description |
|---|---|---|
| 200 OK |
OK - Retorna informações sobre a implantação, incluindo o status de provisionamento. |
|
| Other Status Codes |
Resposta de erro que descreve por que a operação falhou. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory
Tipo:
oauth2
Flow:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Escopos
| Nome | Description |
|---|---|
| user_impersonation | representar sua conta de usuário |
Definições
| Nome | Description |
|---|---|
| Alias |
O tipo de alias. |
|
Alias |
O tipo dos caminhos para alias. |
|
Alias |
Os atributos do token ao qual o caminho do alias está se referindo. |
|
Alias |
|
|
Alias |
O tipo do token ao qual o caminho do alias está se referindo. |
|
Alias |
O tipo do padrão para um caminho de alias. |
|
Alias |
O tipo de padrão de alias |
|
Alias |
O tipo do alias. |
|
Api |
|
|
Basic |
Informações de dependência de implantação. |
|
Cloud |
Uma resposta de erro para uma solicitação de gerenciamento de recursos. |
|
Debug |
A configuração de depuração. |
| Dependency |
Informações de dependência de implantação. |
|
Deployment |
|
|
Deployment |
Informações de implantação. |
|
Deployment |
|
|
Deployment |
|
|
Deployment |
O modo usado para implantar recursos. Esse valor pode ser Incremental ou Concluído. No modo incremental, os recursos são implantados sem excluir recursos existentes que não estão incluídos no modelo. No modo Completo, os recursos são implantados e os recursos existentes no grupo de recursos que não estão incluídos no modelo são excluídos. Tenha cuidado ao usar o modo Completo, pois você pode excluir recursos sem querer. |
|
Deployment |
Propriedades de implantação com detalhes adicionais. |
|
Error |
As informações adicionais do erro de gerenciamento de recursos. |
|
Error |
Resposta de erro |
|
Extension |
|
|
Key |
Referência de parâmetro do Azure Key Vault. |
|
Key |
Referência do Azure Key Vault. |
| Level |
Indica o nível de resposta adicional. |
|
On |
Implantação no comportamento de erro com detalhes adicionais. |
|
On |
A implantação no tipo de comportamento de erro. Os valores possíveis são LastSuccessful e SpecificDeployment. |
|
Parameters |
Entidade que representa a referência aos parâmetros de implantação. |
| Provider |
Informações do provedor de recursos. |
|
Provider |
O estado de consentimento de autorização do provedor. |
|
Provider |
O local estendido do provedor. |
|
Provider |
Tipo de recurso gerenciado pelo provedor de recursos. |
|
Provisioning |
Indica o estado do provisionamento. |
|
Resource |
O modelo de ID do recurso. |
|
Template |
Entidade que representa a referência ao modelo. |
|
Validation |
O nível de validação executado na implantação. |
|
Zone |
Alias
O tipo de alias.
| Nome | Tipo | Description |
|---|---|---|
| defaultMetadata |
Os metadados de caminho do alias padrão. Aplica-se ao caminho padrão e a qualquer caminho de alias que não tenha metadados |
|
| defaultPath |
string |
O caminho padrão para um alias. |
| defaultPattern |
O padrão padrão para um alias. |
|
| name |
string |
O nome do alias. |
| paths |
Os caminhos para um alias. |
|
| type |
O tipo do alias. |
AliasPath
O tipo dos caminhos para alias.
| Nome | Tipo | Description |
|---|---|---|
| apiVersions |
string[] |
As versões da API. |
| metadata |
Os metadados do caminho do alias. Se estiver ausente, volte para os metadados padrão do alias. |
|
| path |
string |
O caminho de um alias. |
| pattern |
O padrão de um caminho de alias. |
AliasPathAttributes
Os atributos do token ao qual o caminho do alias está se referindo.
| Valor | Description |
|---|---|
| None |
O token ao qual o caminho do alias está se referindo não tem atributos. |
| Modifiable |
O token ao qual o caminho do alias está se referindo é modificável por políticas com efeito 'modify'. |
AliasPathMetadata
| Nome | Tipo | Description |
|---|---|---|
| attributes |
Os atributos do token ao qual o caminho do alias está se referindo. |
|
| type |
O tipo do token ao qual o caminho do alias está se referindo. |
AliasPathTokenType
O tipo do token ao qual o caminho do alias está se referindo.
| Valor | Description |
|---|---|
| NotSpecified |
O tipo de token não é especificado. |
| Any |
O tipo de token pode ser qualquer coisa. |
| String |
O tipo de token é cadeia de caracteres. |
| Object |
O tipo de token é objeto. |
| Array |
O tipo de token é matriz. |
| Integer |
O tipo de token é inteiro. |
| Number |
O tipo de token é número. |
| Boolean |
O tipo de token é booliano. |
AliasPattern
O tipo do padrão para um caminho de alias.
| Nome | Tipo | Description |
|---|---|---|
| phrase |
string |
A frase padrão de alias. |
| type |
O tipo de padrão de alias |
|
| variable |
string |
A variável de padrão de alias. |
AliasPatternType
O tipo de padrão de alias
| Valor | Description |
|---|---|
| NotSpecified |
NotSpecified não é permitido. |
| Extract |
Extração é o único valor permitido. |
AliasType
O tipo do alias.
| Valor | Description |
|---|---|
| NotSpecified |
O tipo de alias é desconhecido (o mesmo que não fornecer tipo de alias). |
| PlainText |
O valor do alias não é secreto. |
| Mask |
O valor do alias é secreto. |
ApiProfile
| Nome | Tipo | Description |
|---|---|---|
| apiVersion |
string |
A versão da API. |
| profileVersion |
string |
A versão do perfil. |
BasicDependency
Informações de dependência de implantação.
| Nome | Tipo | Description |
|---|---|---|
| id |
string |
A ID da dependência. |
| resourceName |
string |
O nome do recurso de dependência. |
| resourceType |
string |
O tipo de recurso de dependência. |
CloudError
Uma resposta de erro para uma solicitação de gerenciamento de recursos.
| Nome | Tipo | Description |
|---|---|---|
| error |
Resposta de erro |
DebugSetting
A configuração de depuração.
| Nome | Tipo | Description |
|---|---|---|
| detailLevel |
string |
Especifica o tipo de informação a ser registrada em log para depuração. Os valores permitidos são none, requestContent, responseContent ou requestContent e responseContent separados por uma vírgula. O padrão é nenhum. Ao definir esse valor, considere cuidadosamente o tipo de informação que você está passando durante a implantação. Ao registrar em log informações sobre a solicitação ou resposta, você pode potencialmente expor dados confidenciais recuperados por meio das operações de implantação. |
Dependency
Informações de dependência de implantação.
| Nome | Tipo | Description |
|---|---|---|
| dependsOn |
A lista de dependências. |
|
| id |
string |
A ID da dependência. |
| resourceName |
string |
O nome do recurso de dependência. |
| resourceType |
string |
O tipo de recurso de dependência. |
DeploymentDiagnosticsDefinition
| Nome | Tipo | Description |
|---|---|---|
| additionalInfo |
As informações adicionais do erro. |
|
| code |
string |
O código de erro. |
| level |
Indica o nível de resposta adicional. |
|
| message |
string |
A mensagem de erro. |
| target |
string |
O destino do erro. |
DeploymentExtended
Informações de implantação.
| Nome | Tipo | Description |
|---|---|---|
| id |
string |
A ID da implantação. |
| location |
string |
o local da implantação. |
| name |
string |
O nome da implementação. |
| properties |
Propriedades de implantação. |
|
| tags |
object |
Marcas de implantação |
| type |
string |
O tipo da implantação. |
DeploymentExtensionConfigItem
| Nome | Tipo | Description |
|---|---|---|
| keyVaultReference |
A referência do Azure Key Vault usada para recuperar o valor secreto da propriedade de configuração de extensão. |
|
| type |
O tipo de valor da propriedade de configuração de extensão. |
|
| value |
O valor da propriedade de configuração de extensão. |
DeploymentExtensionDefinition
| Nome | Tipo | Description |
|---|---|---|
| alias |
string |
O alias da extensão, conforme definido no modelo de implantação. |
| config |
<string,
Deployment |
A configuração da extensão. |
| configId |
string |
A ID de configuração da extensão. Ele identifica exclusivamente um plano de controle de implantação em uma extensão. |
| name |
string |
O nome da extensão. |
| version |
string |
A versão de extensão. |
DeploymentMode
O modo usado para implantar recursos. Esse valor pode ser Incremental ou Concluído. No modo incremental, os recursos são implantados sem excluir recursos existentes que não estão incluídos no modelo. No modo Completo, os recursos são implantados e os recursos existentes no grupo de recursos que não estão incluídos no modelo são excluídos. Tenha cuidado ao usar o modo Completo, pois você pode excluir recursos sem querer.
| Valor | Description |
|---|---|
| Incremental | |
| Complete |
DeploymentPropertiesExtended
Propriedades de implantação com detalhes adicionais.
| Nome | Tipo | Description |
|---|---|---|
| correlationId |
string |
A ID de correlação da implantação. |
| debugSetting |
A configuração de depuração da implantação. |
|
| dependencies |
A lista de dependências de implantação. |
|
| diagnostics |
Contém informações de diagnóstico coletadas durante o processo de validação. |
|
| duration |
string |
A duração da implantação do modelo. |
| error |
Resposta de erro |
|
| extensions |
As extensões usadas nesta implantação. |
|
| mode |
O modo de implantação. Os valores possíveis são Incrementais e Concluídos. |
|
| onErrorDeployment |
A implantação no comportamento de erro. |
|
| outputResources |
Matriz de recursos provisionados. |
|
| outputs |
object |
Pares chave/valor que representam a saída da implantação. |
| parameters |
object |
Parâmetros de implantação. |
| parametersLink |
O URI que faz referência aos parâmetros. |
|
| providers |
Provider[] |
A lista de provedores de recursos necessários para a implantação. |
| provisioningState |
Indica o estado do provisionamento. |
|
| templateHash |
string |
O hash produzido para o modelo. |
| templateLink |
O URI que faz referência ao modelo. |
|
| timestamp |
string (date-time) |
O carimbo de data/hora da implantação do modelo. |
| validatedResources |
Matriz de recursos validados. |
|
| validationLevel |
O nível de validação da implantação |
ErrorAdditionalInfo
As informações adicionais do erro de gerenciamento de recursos.
| Nome | Tipo | Description |
|---|---|---|
| info |
object |
As informações adicionais. |
| type |
string |
O tipo de informação adicional. |
ErrorResponse
Resposta de erro
| Nome | Tipo | Description |
|---|---|---|
| additionalInfo |
As informações adicionais do erro. |
|
| code |
string |
O código de erro. |
| details |
Os detalhes do erro. |
|
| message |
string |
A mensagem de erro. |
| target |
string |
O destino do erro. |
ExtensionConfigPropertyType
| Valor | Description |
|---|---|
| String |
Tipo de propriedade que representa um valor de cadeia de caracteres. |
| Int |
Tipo de propriedade que representa um valor inteiro. |
| Bool |
Tipo de propriedade que representa um valor booleano. |
| Array |
Tipo de propriedade que representa um valor de matriz. |
| Object |
Tipo de propriedade que representa um valor de objeto. |
| SecureString |
Tipo de propriedade que representa um valor de cadeia de caracteres segura. |
| SecureObject |
Tipo de propriedade que representa um valor de objeto seguro. |
KeyVaultParameterReference
Referência de parâmetro do Azure Key Vault.
| Nome | Tipo | Description |
|---|---|---|
| keyVault |
Referência do Azure Key Vault. |
|
| secretName |
string |
Nome do segredo do Azure Key Vault. |
| secretVersion |
string |
Versão secreta do Azure Key Vault. |
KeyVaultReference
Referência do Azure Key Vault.
| Nome | Tipo | Description |
|---|---|---|
| id |
string |
ID do recurso do Azure Key Vault. |
Level
Indica o nível de resposta adicional.
| Valor | Description |
|---|---|
| Warning | |
| Info | |
| Error |
OnErrorDeploymentExtended
Implantação no comportamento de erro com detalhes adicionais.
| Nome | Tipo | Description |
|---|---|---|
| deploymentName |
string |
A implantação a ser usada no caso de erro. |
| provisioningState |
string |
O estado do provisionamento para a implantação por erro. |
| type |
A implantação no tipo de comportamento de erro. Os valores possíveis são LastSuccessful e SpecificDeployment. |
OnErrorDeploymentType
A implantação no tipo de comportamento de erro. Os valores possíveis são LastSuccessful e SpecificDeployment.
| Valor | Description |
|---|---|
| LastSuccessful | |
| SpecificDeployment |
ParametersLink
Entidade que representa a referência aos parâmetros de implantação.
| Nome | Tipo | Description |
|---|---|---|
| contentVersion |
string |
Se incluído, deverá corresponder ao ContentVersion no modelo. |
| uri |
string |
O URI do arquivo de parâmetros. |
Provider
Informações do provedor de recursos.
| Nome | Tipo | Description |
|---|---|---|
| id |
string |
A ID do provedor. |
| namespace |
string |
O namespace do provedor de recursos. |
| providerAuthorizationConsentState |
O estado de consentimento de autorização do provedor. |
|
| registrationPolicy |
string |
A política de registro do provedor de recursos. |
| registrationState |
string |
O estado de registro do provedor de recursos. |
| resourceTypes |
A coleção de tipos de recursos do provedor. |
ProviderAuthorizationConsentState
O estado de consentimento de autorização do provedor.
| Valor | Description |
|---|---|
| NotSpecified | |
| Required | |
| NotRequired | |
| Consented |
ProviderExtendedLocation
O local estendido do provedor.
| Nome | Tipo | Description |
|---|---|---|
| extendedLocations |
string[] |
Os locais estendidos para o local do azure. |
| location |
string |
O local do azure. |
| type |
string |
O tipo de local estendido. |
ProviderResourceType
Tipo de recurso gerenciado pelo provedor de recursos.
| Nome | Tipo | Description |
|---|---|---|
| aliases |
Alias[] |
Os aliases compatíveis com esse tipo de recurso. |
| apiProfiles |
Os perfis de API para o provedor de recursos. |
|
| apiVersions |
string[] |
A versão da API. |
| capabilities |
string |
Os recursos adicionais oferecidos por esse tipo de recurso. |
| defaultApiVersion |
string |
A versão padrão da API. |
| locationMappings |
Os mapeamentos de localização compatíveis com esse tipo de recurso. |
|
| locations |
string[] |
A coleção de locais em que esse tipo de recurso pode ser criado. |
| properties |
object |
As propriedades. |
| resourceType |
string |
O tipo de recurso. |
| zoneMappings |
ProvisioningState
Indica o estado do provisionamento.
| Valor | Description |
|---|---|
| NotSpecified | |
| Accepted | |
| Running | |
| Ready | |
| Creating | |
| Created | |
| Deleting | |
| Deleted | |
| Canceled | |
| Failed | |
| Succeeded | |
| Updating |
ResourceReference
O modelo de ID do recurso.
| Nome | Tipo | Description |
|---|---|---|
| apiVersion |
string |
A versão da API com a qual o recurso foi implantado. |
| extension |
A extensão com a qual o recurso foi implantado. |
|
| id |
string |
A ID de recurso do Azure totalmente qualificada. |
| identifiers |
object |
Os identificadores de recursos extensíveis. |
| resourceType |
string |
O tipo de recurso. |
TemplateLink
Entidade que representa a referência ao modelo.
| Nome | Tipo | Description |
|---|---|---|
| contentVersion |
string |
Se incluído, deverá corresponder ao ContentVersion no modelo. |
| id |
string |
A ID de recurso de uma Especificação de Modelo. Use a propriedade id ou uri, mas não ambas. |
| queryString |
string |
A cadeia de caracteres de consulta (por exemplo, um token SAS) a ser usada com o URI templateLink. |
| relativePath |
string |
A propriedade relativePath pode ser usada para implantar um modelo vinculado em um local relativo ao pai. Se o modelo pai estiver vinculado a um TemplateSpec, isso fará referência a um artefato no TemplateSpec. Se o pai estiver vinculado a um URI, a implantação filho será uma combinação das URIs pai e relativePath |
| uri |
string |
O URI do modelo a ser implantado. Use a propriedade uri ou id, mas não ambos. |
ValidationLevel
O nível de validação executado na implantação.
| Valor | Description |
|---|---|
| Template |
A análise estática do modelo é executada. |
| Provider |
A análise estática do modelo é executada e as declarações de recursos são enviadas aos provedores de recursos para validação semântica. Valida se o chamador tem permissões de gravação RBAC em cada recurso. |
| ProviderNoRbac |
A análise estática do modelo é executada e as declarações de recursos são enviadas aos provedores de recursos para validação semântica. Ignora a validação de que o chamador tem permissões de gravação RBAC em cada recurso. |
ZoneMapping
| Nome | Tipo | Description |
|---|---|---|
| location |
string |
O local do mapeamento de zona. |
| zones |
string[] |