Deployments - Create Or Update
Implanta recursos em um grupo de recursos.
Você pode fornecer o modelo e os parâmetros diretamente na solicitação ou link para arquivos JSON.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version=2025-04-01
Parâ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 para o qual implantar os recursos. O nome não diferencia maiúsculas de minúsculas. O grupo de recursos já precisa existir. |
|
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. |
Corpo da solicitação
| Nome | Obrigatório | Tipo | Description |
|---|---|---|---|
| properties | True |
As propriedades de implantação. |
|
| identity |
A configuração de Identidade Gerenciada para uma implantação. |
||
| location |
string |
O local para armazenar os dados de implantação. |
|
| tags |
object |
Marcas de implantação |
Respostas
| Nome | Tipo | Description |
|---|---|---|
| 200 OK |
OK - Retorna informações sobre a implantação, incluindo o status de provisionamento. |
|
| 201 Created |
Criado – 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 |
Exemplos
Create a deployment that will deploy a template with a uri and queryString
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000001/resourcegroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment?api-version=2025-04-01
{
"properties": {
"templateLink": {
"uri": "https://example.com/exampleTemplate.json",
"queryString": "sv=2019-02-02&st=2019-04-29T22%3A18%3A26Z&se=2019-04-30T02%3A23%3A26Z&sr=b&sp=rw&sip=168.1.5.60-168.1.5.70&spr=https&sig=xxxxxxxx0xxxxxxxxxxxxx%2bxxxxxxxxxxxxxxxxxxxx%3d"
},
"parameters": {},
"mode": "Incremental"
}
}
Resposta de exemplo
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
"name": "my-deployment",
"type": "Microsoft.Resources/deployments",
"properties": {
"templateLink": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1",
"contentVersion": "1.0.0.0"
},
"templateHash": "0000000000000000000",
"parameters": {},
"mode": "Incremental",
"provisioningState": "Succeeded",
"timestamp": "2020-06-05T01:20:01.723776Z",
"duration": "PT22.8356799S",
"correlationId": "00000000-0000-0000-0000-000000000000",
"providers": [
{
"namespace": "Microsoft.Storage",
"resourceTypes": [
{
"resourceType": "storageAccounts",
"locations": [
"eastus"
]
}
]
}
],
"dependencies": [],
"outputResources": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Storage/storageAccounts/my-storage-account"
}
]
}
}
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
"name": "my-deployment",
"type": "Microsoft.Resources/deployments",
"properties": {
"templateLink": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1",
"contentVersion": "1.0.0.0"
},
"templateHash": "0000000000000000000",
"parameters": {},
"mode": "Incremental",
"provisioningState": "Accepted",
"timestamp": "2020-06-05T01:20:01.723776Z",
"duration": "PT22.8356799S",
"correlationId": "00000000-0000-0000-0000-000000000000",
"providers": [
{
"namespace": "Microsoft.Storage",
"resourceTypes": [
{
"resourceType": "storageAccounts",
"locations": [
"eastus"
]
}
]
}
],
"dependencies": []
}
}
Create a deployment that will deploy a templateSpec with the given resourceId
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000001/resourcegroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment?api-version=2025-04-01
{
"properties": {
"templateLink": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1"
},
"parameters": {},
"mode": "Incremental"
}
}
Resposta de exemplo
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
"name": "my-deployment",
"type": "Microsoft.Resources/deployments",
"properties": {
"templateLink": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1",
"contentVersion": "1.0.0.0"
},
"templateHash": "0000000000000000000",
"parameters": {},
"mode": "Incremental",
"provisioningState": "Succeeded",
"timestamp": "2020-06-05T01:20:01.723776Z",
"duration": "PT22.8356799S",
"correlationId": "00000000-0000-0000-0000-000000000000",
"providers": [
{
"namespace": "Microsoft.Storage",
"resourceTypes": [
{
"resourceType": "storageAccounts",
"locations": [
"eastus"
]
}
]
}
],
"dependencies": [],
"outputResources": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Storage/storageAccounts/my-storage-account"
}
]
}
}
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
"name": "my-deployment",
"type": "Microsoft.Resources/deployments",
"properties": {
"templateLink": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1",
"contentVersion": "1.0.0.0"
},
"templateHash": "0000000000000000000",
"parameters": {},
"mode": "Incremental",
"provisioningState": "Accepted",
"timestamp": "2020-06-05T01:20:01.723776Z",
"duration": "PT22.8356799S",
"correlationId": "00000000-0000-0000-0000-000000000000",
"providers": [
{
"namespace": "Microsoft.Storage",
"resourceTypes": [
{
"resourceType": "storageAccounts",
"locations": [
"eastus"
]
}
]
}
],
"dependencies": []
}
}
Create a deployment that will redeploy another deployment on failure
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment?api-version=2025-04-01
{
"properties": {
"templateLink": {
"uri": "https://example.com/exampleTemplate.json"
},
"parameters": {},
"mode": "Complete",
"onErrorDeployment": {
"type": "SpecificDeployment",
"deploymentName": "name-of-deployment-to-use"
}
}
}
Resposta de exemplo
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
"name": "my-deployment",
"type": "Microsoft.Resources/deployments",
"properties": {
"templateLink": {
"uri": "https://example.com/exampleTemplate.json",
"contentVersion": "1.0.0.0"
},
"parameters": {},
"mode": "Complete",
"provisioningState": "Accepted",
"timestamp": "2019-03-01T00:00:00.0000000Z",
"duration": "PT0.8204881S",
"correlationId": "00000000-0000-0000-0000-000000000000",
"providers": [
{
"namespace": "Microsoft.Network",
"resourceTypes": [
{
"resourceType": "virtualNetworks",
"locations": [
"centralus"
]
},
{
"resourceType": "virtualNetworks/subnets",
"locations": [
"centralus"
]
}
]
}
],
"dependencies": [
{
"dependsOn": [
{
"id": "{resourceid}",
"resourceType": "Microsoft.Network/virtualNetworks",
"resourceName": "VNet1"
}
],
"id": "{resourceid}",
"resourceType": "Microsoft.Network/virtualNetworks/subnets",
"resourceName": "VNet1/Subnet1"
},
{
"dependsOn": [
{
"id": "{resourceid}",
"resourceType": "Microsoft.Network/virtualNetworks",
"resourceName": "VNet1"
},
{
"id": "{resourceid}",
"resourceType": "Microsoft.Network/virtualNetworks/subnets",
"resourceName": "VNet1/Subnet1"
}
],
"id": "{resourceid}",
"resourceType": "Microsoft.Network/virtualNetworks/subnets",
"resourceName": "VNet1/Subnet2"
}
],
"onErrorDeployment": {
"type": "SpecificDeployment",
"deploymentName": "name-of-deployment-to-use"
}
}
}
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
"name": "my-deployment",
"type": "Microsoft.Resources/deployments",
"properties": {
"templateLink": {
"uri": "https://example.com/exampleTemplate.json",
"contentVersion": "1.0.0.0"
},
"parameters": {},
"mode": "Complete",
"provisioningState": "Accepted",
"timestamp": "2019-03-01T00:00:00.0000000Z",
"duration": "PT0.8204881S",
"correlationId": "00000000-0000-0000-0000-000000000000",
"providers": [
{
"namespace": "Microsoft.Network",
"resourceTypes": [
{
"resourceType": "virtualNetworks",
"locations": [
"centralus"
]
},
{
"resourceType": "virtualNetworks/subnets",
"locations": [
"centralus"
]
}
]
}
],
"dependencies": [
{
"dependsOn": [
{
"id": "{resourceid}",
"resourceType": "Microsoft.Network/virtualNetworks",
"resourceName": "VNet1"
}
],
"id": "{resourceid}",
"resourceType": "Microsoft.Network/virtualNetworks/subnets",
"resourceName": "VNet1/Subnet1"
},
{
"dependsOn": [
{
"id": "{resourceid}",
"resourceType": "Microsoft.Network/virtualNetworks",
"resourceName": "VNet1"
},
{
"id": "{resourceid}",
"resourceType": "Microsoft.Network/virtualNetworks/subnets",
"resourceName": "VNet1/Subnet1"
}
],
"id": "{resourceid}",
"resourceType": "Microsoft.Network/virtualNetworks/subnets",
"resourceName": "VNet1/Subnet2"
}
],
"onErrorDeployment": {
"type": "SpecificDeployment",
"deploymentName": "name-of-deployment-to-use"
}
}
}
Create a deployment that will redeploy the last successful deployment on failure
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment?api-version=2025-04-01
{
"properties": {
"templateLink": {
"uri": "https://example.com/exampleTemplate.json"
},
"parameters": {},
"mode": "Complete",
"onErrorDeployment": {
"type": "LastSuccessful"
}
}
}
Resposta de exemplo
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
"name": "my-deployment",
"type": "Microsoft.Resources/deployments",
"properties": {
"templateLink": {
"uri": "https://example.com/exampleTemplate.json",
"contentVersion": "1.0.0.0"
},
"parameters": {},
"mode": "Complete",
"provisioningState": "Accepted",
"timestamp": "2019-03-01T00:00:00.0000000Z",
"duration": "PT0.8204881S",
"correlationId": "00000000-0000-0000-0000-000000000000",
"providers": [
{
"namespace": "Microsoft.Network",
"resourceTypes": [
{
"resourceType": "virtualNetworks",
"locations": [
"centralus"
]
},
{
"resourceType": "virtualNetworks/subnets",
"locations": [
"centralus"
]
}
]
}
],
"dependencies": [
{
"dependsOn": [
{
"id": "{resourceid}",
"resourceType": "Microsoft.Network/virtualNetworks",
"resourceName": "VNet1"
}
],
"id": "{resourceid}",
"resourceType": "Microsoft.Network/virtualNetworks/subnets",
"resourceName": "VNet1/Subnet1"
},
{
"dependsOn": [
{
"id": "{resourceid}",
"resourceType": "Microsoft.Network/virtualNetworks",
"resourceName": "VNet1"
},
{
"id": "{resourceid}",
"resourceType": "Microsoft.Network/virtualNetworks/subnets",
"resourceName": "VNet1/Subnet1"
}
],
"id": "{resourceid}",
"resourceType": "Microsoft.Network/virtualNetworks/subnets",
"resourceName": "VNet1/Subnet2"
}
],
"onErrorDeployment": {
"type": "LastSuccessful",
"deploymentName": "{nameOfLastSuccesfulDeployment}"
}
}
}
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
"name": "my-deployment",
"type": "Microsoft.Resources/deployments",
"properties": {
"templateLink": {
"uri": "https://example.com/exampleTemplate.json",
"contentVersion": "1.0.0.0"
},
"parameters": {},
"mode": "Complete",
"provisioningState": "Accepted",
"timestamp": "2019-03-01T00:00:00.0000000Z",
"duration": "PT0.8204881S",
"correlationId": "00000000-0000-0000-0000-000000000000",
"providers": [
{
"namespace": "Microsoft.Network",
"resourceTypes": [
{
"resourceType": "virtualNetworks",
"locations": [
"centralus"
]
},
{
"resourceType": "virtualNetworks/subnets",
"locations": [
"centralus"
]
}
]
}
],
"dependencies": [
{
"dependsOn": [
{
"id": "{resourceid}",
"resourceType": "Microsoft.Network/virtualNetworks",
"resourceName": "VNet1"
}
],
"id": "{resourceid}",
"resourceType": "Microsoft.Network/virtualNetworks/subnets",
"resourceName": "VNet1/Subnet1"
},
{
"dependsOn": [
{
"id": "{resourceid}",
"resourceType": "Microsoft.Network/virtualNetworks",
"resourceName": "VNet1"
},
{
"id": "{resourceid}",
"resourceType": "Microsoft.Network/virtualNetworks/subnets",
"resourceName": "VNet1/Subnet1"
}
],
"id": "{resourceid}",
"resourceType": "Microsoft.Network/virtualNetworks/subnets",
"resourceName": "VNet1/Subnet2"
}
],
"onErrorDeployment": {
"type": "LastSuccessful",
"deploymentName": "{nameOfLastSuccesfulDeployment}"
}
}
}
Create deployment using external inputs
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000001/resourcegroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment?api-version=2025-04-01
{
"properties": {
"template": {
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"inputObj": {
"type": "object"
}
},
"resources": [],
"outputs": {
"inputObj": {
"type": "object",
"value": "[parameters('inputObj')]"
}
}
},
"parameters": {
"inputObj": {
"expression": "[createObject('foo', externalInputs('fooValue'))]"
}
},
"externalInputDefinitions": {
"fooValue": {
"kind": "sys.envVar",
"config": "FOO_VALUE"
}
},
"externalInputs": {
"fooValue": {
"value": "baz"
}
},
"mode": "Incremental"
}
}
Resposta de exemplo
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
"name": "my-deployment",
"type": "Microsoft.Resources/deployments",
"properties": {
"templateHash": "17686481789412793580",
"parameters": {
"inputObj": {
"type": "Object",
"value": {
"foo": "baz"
}
}
},
"mode": "Incremental",
"provisioningState": "Succeeded",
"timestamp": "2025-04-09T14:36:48.2047169Z",
"correlationId": "ef613b6c-f76e-48fd-9da7-28884243c5e5",
"providers": [],
"dependencies": [],
"outputs": {
"inputObj": {
"type": "Object",
"value": {
"foo": "baz"
}
}
},
"outputResources": []
}
}
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
"name": "my-deployment",
"type": "Microsoft.Resources/deployments",
"properties": {
"templateHash": "17686481789412793580",
"parameters": {
"inputObj": {
"type": "Object",
"value": {
"foo": "baz"
}
}
},
"mode": "Incremental",
"provisioningState": "Accepted",
"timestamp": "2025-04-09T14:36:47.6637583Z",
"duration": "PT0.0009164S",
"correlationId": "ef613b6c-f76e-48fd-9da7-28884243c5e5",
"providers": [],
"dependencies": []
}
}
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 |
Parâmetros de operação de implantação. |
|
Deployment |
|
|
Deployment |
Informações de implantação. |
|
Deployment |
|
|
Deployment |
|
|
Deployment |
Entrada externa de implantação para parametrização. |
|
Deployment |
Definição de entrada externa de implantação para parametrização. |
|
Deployment |
A configuração de Identidade Gerenciada para uma implantação. |
|
Deployment |
O tipo de identidade. |
|
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 |
Parâmetro de implantação para o modelo. |
|
Deployment |
Propriedades de implantação. |
|
Deployment |
Propriedades de implantação com detalhes adicionais. |
|
Error |
As informações adicionais do erro de gerenciamento de recursos. |
|
Error |
Resposta de erro |
|
Expression |
Especifica se as expressões de modelo são avaliadas dentro do escopo do modelo pai ou do modelo aninhado. |
|
Expression |
O escopo a ser usado para avaliação de parâmetros, variáveis e funções em um modelo aninhado. |
|
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. |
|
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. |
|
User |
Propriedades de identidade atribuídas pelo usuário |
|
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. |
Deployment
Parâmetros de operação de implantação.
| Nome | Tipo | Description |
|---|---|---|
| identity |
A configuração de Identidade Gerenciada para uma implantação. |
|
| location |
string |
O local para armazenar os dados de implantação. |
| properties |
As propriedades de implantação. |
|
| tags |
object |
Marcas de implantação |
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. |
DeploymentExternalInput
Entrada externa de implantação para parametrização.
| Nome | Tipo | Description |
|---|---|---|
| value |
Valor de entrada externo. |
DeploymentExternalInputDefinition
Definição de entrada externa de implantação para parametrização.
| Nome | Tipo | Description |
|---|---|---|
| config |
Configuração para a entrada externa. |
|
| kind |
string |
O tipo de entrada externa. |
DeploymentIdentity
A configuração de Identidade Gerenciada para uma implantação.
| Nome | Tipo | Description |
|---|---|---|
| type |
O tipo de identidade. |
|
| userAssignedIdentities |
<string,
User |
O conjunto de identidades atribuídas pelo usuário associadas ao recurso. |
DeploymentIdentityType
O tipo de identidade.
| Valor | Description |
|---|---|
| None | |
| UserAssigned |
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 |
DeploymentParameter
Parâmetro de implantação para o modelo.
| Nome | Tipo | Description |
|---|---|---|
| expression |
string |
Expressão de entrada para o parâmetro. |
| reference |
Referência de parâmetro do Azure Key Vault. |
|
| value |
Insira o valor para o parâmetro . |
DeploymentProperties
Propriedades de implantação.
| Nome | Tipo | Description |
|---|---|---|
| debugSetting |
A configuração de depuração da implantação. |
|
| expressionEvaluationOptions |
Especifica se as expressões de modelo são avaliadas dentro do escopo do modelo pai ou do modelo aninhado. Aplicável somente a modelos aninhados. Se não for especificado, o valor padrão será outer. |
|
| extensionConfigs |
object |
As configurações a serem usadas para extensões de implantação. As chaves desse objeto são aliases de extensão de implantação, conforme definido no modelo de implantação. |
| externalInputDefinitions |
<string,
Deployment |
Definições de entrada externa, usadas por ferramentas externas para definir valores de entrada externos esperados. |
| externalInputs |
<string,
Deployment |
Valores de entrada externos, usados por ferramentas externas para avaliação de parâmetros. |
| mode |
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. |
|
| onErrorDeployment |
A implantação no comportamento de erro. |
|
| parameters |
<string,
Deployment |
Pares de nome e valor que definem os parâmetros de implantação para o modelo. Use esse elemento quando quiser fornecer os valores de parâmetro diretamente na solicitação em vez de vincular a um arquivo de parâmetro existente. Use a propriedade parametersLink ou a propriedade parameters, mas não ambos. Pode ser um JObject ou uma cadeia de caracteres JSON bem formada. |
| parametersLink |
O URI do arquivo de parâmetros. Use esse elemento para vincular a um arquivo de parâmetros existente. Use a propriedade parametersLink ou a propriedade parameters, mas não ambos. |
|
| template |
object |
O conteúdo do modelo. Use esse elemento quando quiser passar a sintaxe do modelo diretamente na solicitação em vez de vincular a um modelo existente. Pode ser uma cadeia de caracteres JObject ou JSON bem formada. Use a propriedade templateLink ou a propriedade de modelo, mas não ambos. |
| templateLink |
O URI do modelo. Use a propriedade templateLink ou a propriedade de modelo, mas não ambos. |
|
| validationLevel |
O nível de validação da implantação |
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. |
ExpressionEvaluationOptions
Especifica se as expressões de modelo são avaliadas dentro do escopo do modelo pai ou do modelo aninhado.
| Nome | Tipo | Description |
|---|---|---|
| scope |
O escopo a ser usado para avaliação de parâmetros, variáveis e funções em um modelo aninhado. |
ExpressionEvaluationOptionsScopeType
O escopo a ser usado para avaliação de parâmetros, variáveis e funções em um modelo aninhado.
| Valor | Description |
|---|---|
| NotSpecified | |
| Outer | |
| Inner |
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 |
OnErrorDeployment
Implantação no comportamento de erro.
| Nome | Tipo | Description |
|---|---|---|
| deploymentName |
string |
A implantação a ser usada no caso de erro. |
| type |
A implantação no tipo de comportamento de erro. Os valores possíveis são LastSuccessful e SpecificDeployment. |
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. |
UserAssignedIdentity
Propriedades de identidade atribuídas pelo usuário
| Nome | Tipo | Description |
|---|---|---|
| clientId |
string (uuid) |
A ID do cliente da identidade atribuída. |
| principalId |
string (uuid) |
A ID da entidade de segurança da identidade atribuída. |
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[] |