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 vincular a arquivos JSON.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version=2025-04-01
Parâmetros do URI
| Name | Em | Necessário | Tipo | Description |
|---|---|---|---|---|
|
deployment
|
path | True |
string minLength: 1maxLength: 64 pattern: ^[-\w\._\(\)]+$ |
O nome da implantaçã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á deve existir. |
|
subscription
|
path | True |
string |
A ID de assinatura do Microsoft Azure. |
|
api-version
|
query | True |
string |
A versão da API a utilizar para esta operação. |
Corpo do Pedido
| Name | Necessá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 |
Tags de implantação |
Respostas
| Name | 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 descrevendo por que a operação falhou. |
Segurança
azure_auth
Azure Ative Directory OAuth2 Flow
Tipo:
oauth2
Fluxo:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Âmbitos
| Name | Description |
|---|---|
| user_impersonation | personificar a sua conta de utilizador |
Exemplos
Create a deployment that will deploy a template with a uri and queryString
Pedido de amostra
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 da amostra
{
"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
Pedido de amostra
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 da amostra
{
"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
Pedido de amostra
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 da amostra
{
"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
Pedido de amostra
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 da amostra
{
"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
Pedido de amostra
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 da amostra
{
"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
| Name | Description |
|---|---|
| Alias |
O tipo de alias. |
|
Alias |
O tipo de caminhos para alias. |
|
Alias |
Os atributos do token ao qual o caminho do alias está se referindo. |
|
Alias |
|
|
Alias |
O tipo de 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 |
Implantação de entrada externa 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 Completo. No modo Incremental, os recursos são implantados sem excluir os 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 involuntariamente. |
|
Deployment |
Parâmetro de implantação para o modelo. |
|
Deployment |
Propriedades de implantação. |
|
Deployment |
Propriedades de implantação com detalhes adicionais. |
|
Error |
O erro de gerenciamento de recursos informações adicionais. |
|
Error |
Resposta de erro |
|
Expression |
Especifica se as expressões de modelo são avaliadas dentro do escopo do modelo pai ou 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 em comportamento de erro. |
|
On |
Implantação sobre 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 |
A localização estendida do provedor. |
|
Provider |
Tipo de recurso gerenciado pelo provedor de recursos. |
|
Provisioning |
Indica o estado de 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 realizado na implantação. |
|
Zone |
Alias
O tipo de alias.
| Name | Tipo | Description |
|---|---|---|
| defaultMetadata |
Os metadados de caminho de 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 de caminhos para alias.
| Name | 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 para 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 'modificar'. |
AliasPathMetadata
| Name | Tipo | Description |
|---|---|---|
| attributes |
Os atributos do token ao qual o caminho do alias está se referindo. |
|
| type |
O tipo de token ao qual o caminho do alias está se referindo. |
AliasPathTokenType
O tipo de 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 é string. |
| Object |
O tipo de token é objeto. |
| Array |
O tipo de token é array. |
| Integer |
O tipo de token é inteiro. |
| Number |
O tipo de token é número. |
| Boolean |
O tipo de token é booleano. |
AliasPattern
O tipo do padrão para um caminho de alias.
| Name | 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 |
Extract é o único valor permitido. |
AliasType
O tipo do alias.
| Valor | Description |
|---|---|
| NotSpecified |
O tipo de alias é desconhecido (o mesmo que não fornecer o tipo de alias). |
| PlainText |
O valor do alias não é secreto. |
| Mask |
O valor do alias é secreto. |
ApiProfile
| Name | 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.
| Name | 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.
| Name | Tipo | Description |
|---|---|---|
| error |
Resposta de erro |
DebugSetting
A configuração de depuração.
| Name | Tipo | Description |
|---|---|---|
| detailLevel |
string |
Especifica o tipo de informação a ser registrada para depuração. Os valores permitidos são none, requestContent, responseContent ou ambos 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 informações sobre a solicitação ou resposta, você pode expor dados confidenciais recuperados por meio das operações de implantação. |
Dependency
Informações de dependência de implantação.
| Name | 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.
| Name | 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 |
Tags de implantação |
DeploymentDiagnosticsDefinition
| Name | Tipo | Description |
|---|---|---|
| additionalInfo |
O erro informações adicionais. |
|
| 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.
| Name | Tipo | Description |
|---|---|---|
| id |
string |
A ID da implantação. |
| location |
string |
o local da implantação. |
| name |
string |
O nome da implantação. |
| properties |
Propriedades de implantação. |
|
| tags |
object |
Tags de implantação |
| type |
string |
O tipo de implantação. |
DeploymentExtensionConfigItem
| Name | Tipo | Description |
|---|---|---|
| keyVaultReference |
A referência do Cofre da Chave do Azure usada para recuperar o valor secreto da propriedade de configuração da extensão. |
|
| type |
O tipo de valor da propriedade de configuração de extensão. |
|
| value |
O valor da propriedade extension config. |
DeploymentExtensionDefinition
| Name | 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 |
O ID de configuração da extensão. Ele identifica exclusivamente um plano de controle de implantação dentro de uma extensão. |
| name |
string |
O nome da extensão. |
| version |
string |
A versão de extensão. |
DeploymentExternalInput
Implantação de entrada externa para parametrização.
| Name | Tipo | Description |
|---|---|---|
| value |
Valor de entrada externa. |
DeploymentExternalInputDefinition
Definição de entrada externa de implantação para parametrização.
| Name | 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.
| Name | 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 Completo. No modo Incremental, os recursos são implantados sem excluir os 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 involuntariamente.
| Valor | Description |
|---|---|
| Incremental | |
| Complete |
DeploymentParameter
Parâmetro de implantação para o modelo.
| Name | Tipo | Description |
|---|---|---|
| expression |
string |
Expressão de entrada para o parâmetro. |
| reference |
Referência de parâmetro do Azure Key Vault. |
|
| value |
Valor de entrada para o parâmetro . |
DeploymentProperties
Propriedades de implantação.
| Name | 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 aninhado. Aplicável apenas a modelos aninhados. Se não for especificado, o valor padrão será externo. |
|
| 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 os 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 Completo. No modo Incremental, os recursos são implantados sem excluir os 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 involuntariamente. |
|
| 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 ambas. 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 ambas. |
|
| 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 um JObject ou uma cadeia de caracteres JSON bem formada. Use a propriedade templateLink ou a propriedade template, mas não ambas. |
| templateLink |
O URI do modelo. Use a propriedade templateLink ou a propriedade template, mas não ambas. |
|
| validationLevel |
O nível de validação da implantação |
DeploymentPropertiesExtended
Propriedades de implantação com detalhes adicionais.
| Name | 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 Incremental e Complete. |
|
| 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 de 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
O erro de gerenciamento de recursos informações adicionais.
| Name | Tipo | Description |
|---|---|---|
| info |
object |
As informações adicionais. |
| type |
string |
O tipo de informação adicional. |
ErrorResponse
Resposta de erro
| Name | Tipo | Description |
|---|---|---|
| additionalInfo |
O erro informações adicionais. |
|
| 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 aninhado.
| Name | 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 seguro. |
| SecureObject |
Tipo de propriedade que representa um valor de objeto seguro. |
KeyVaultParameterReference
Referência de parâmetro do Azure Key Vault.
| Name | Tipo | Description |
|---|---|---|
| keyVault |
Referência do Azure Key Vault. |
|
| secretName |
string |
Nome secreto do Azure Key Vault. |
| secretVersion |
string |
Versão secreta do Azure Key Vault. |
KeyVaultReference
Referência do Azure Key Vault.
| Name | 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 em comportamento de erro.
| Name | Tipo | Description |
|---|---|---|
| deploymentName |
string |
A implantação a ser usada em 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 sobre comportamento de erro com detalhes adicionais.
| Name | Tipo | Description |
|---|---|---|
| deploymentName |
string |
A implantação a ser usada em caso de erro. |
| provisioningState |
string |
O estado do provisionamento para a implantação on error. |
| 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.
| Name | Tipo | Description |
|---|---|---|
| contentVersion |
string |
Se incluído, deve corresponder ao ContentVersion no modelo. |
| uri |
string |
O URI do arquivo de parâmetros. |
Provider
Informações do provedor de recursos.
| Name | Tipo | Description |
|---|---|---|
| id |
string |
O 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
A localização estendida do provedor.
| Name | Tipo | Description |
|---|---|---|
| extendedLocations |
string[] |
Os locais estendidos para o local azure. |
| location |
string |
O local azure. |
| type |
string |
O tipo de local estendido. |
ProviderResourceType
Tipo de recurso gerenciado pelo provedor de recursos.
| Name | Tipo | Description |
|---|---|---|
| aliases |
Alias[] |
Os aliases suportados por este 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 local suportados por esse tipo de recurso. |
|
| locations |
string[] |
A coleção de locais onde esse tipo de recurso pode ser criado. |
| properties |
object |
As propriedades. |
| resourceType |
string |
O tipo do recurso. |
| zoneMappings |
ProvisioningState
Indica o estado de provisionamento.
| Valor | Description |
|---|---|
| NotSpecified | |
| Accepted | |
| Running | |
| Ready | |
| Creating | |
| Created | |
| Deleting | |
| Deleted | |
| Canceled | |
| Failed | |
| Succeeded | |
| Updating |
ResourceReference
O modelo de ID do recurso.
| Name | 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 do recurso. |
TemplateLink
Entidade que representa a referência ao modelo.
| Name | Tipo | Description |
|---|---|---|
| contentVersion |
string |
Se incluído, deve corresponder ao ContentVersion no modelo. |
| id |
string |
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 foi vinculado a um TemplateSpec, isso fará referência a um artefato no TemplateSpec. Se o pai foi vinculado a um URI, a implantação filho será uma combinação dos URIs pai e relativePath |
| uri |
string |
O URI do modelo a ser implantado. Use a propriedade uri ou id, mas não ambas. |
UserAssignedIdentity
Propriedades de identidade atribuídas pelo usuário
| Name | Tipo | Description |
|---|---|---|
| clientId |
string (uuid) |
O ID do cliente da identidade atribuída. |
| principalId |
string (uuid) |
O ID principal da identidade atribuída. |
ValidationLevel
O nível de validação realizado na implantação.
| Valor | Description |
|---|---|
| Template |
A análise estática do modelo é realizada. |
| 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
| Name | Tipo | Description |
|---|---|---|
| location |
string |
A localização do mapeamento de zona. |
| zones |
string[] |