Compartilhar via


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
deploymentName
path True

string

minLength: 1
maxLength: 64
pattern: ^[-\w\._\(\)]+$

O nome da implementação.

resourceGroupName
path True

string

minLength: 1
maxLength: 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.

subscriptionId
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

DeploymentProperties

As propriedades de implantação.

identity

DeploymentIdentity

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

DeploymentExtended

OK - Retorna informações sobre a implantação, incluindo o status de provisionamento.

201 Created

DeploymentExtended

Criado – Retorna informações sobre a implantação, incluindo o status de provisionamento.

Other Status Codes

CloudError

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
Create a deployment that will deploy a templateSpec with the given resourceId
Create a deployment that will redeploy another deployment on failure
Create a deployment that will redeploy the last successful deployment on failure
Create deployment using external inputs

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.

AliasPath

O tipo dos caminhos para alias.

AliasPathAttributes

Os atributos do token ao qual o caminho do alias está se referindo.

AliasPathMetadata
AliasPathTokenType

O tipo do token ao qual o caminho do alias está se referindo.

AliasPattern

O tipo do padrão para um caminho de alias.

AliasPatternType

O tipo de padrão de alias

AliasType

O tipo do alias.

ApiProfile
BasicDependency

Informações de dependência de implantação.

CloudError

Uma resposta de erro para uma solicitação de gerenciamento de recursos.

DebugSetting

A configuração de depuração.

Dependency

Informações de dependência de implantação.

Deployment

Parâmetros de operação de implantação.

DeploymentDiagnosticsDefinition
DeploymentExtended

Informações de implantação.

DeploymentExtensionConfigItem
DeploymentExtensionDefinition
DeploymentExternalInput

Entrada externa de implantação para parametrização.

DeploymentExternalInputDefinition

Definição de entrada externa de implantação para parametrização.

DeploymentIdentity

A configuração de Identidade Gerenciada para uma implantação.

DeploymentIdentityType

O tipo de identidade.

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.

DeploymentParameter

Parâmetro de implantação para o modelo.

DeploymentProperties

Propriedades de implantação.

DeploymentPropertiesExtended

Propriedades de implantação com detalhes adicionais.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

ErrorResponse

Resposta de erro

ExpressionEvaluationOptions

Especifica se as expressões de modelo são avaliadas dentro do escopo do modelo pai ou do modelo aninhado.

ExpressionEvaluationOptionsScopeType

O escopo a ser usado para avaliação de parâmetros, variáveis e funções em um modelo aninhado.

ExtensionConfigPropertyType
KeyVaultParameterReference

Referência de parâmetro do Azure Key Vault.

KeyVaultReference

Referência do Azure Key Vault.

Level

Indica o nível de resposta adicional.

OnErrorDeployment

Implantação no comportamento de erro.

OnErrorDeploymentExtended

Implantação no comportamento de erro com detalhes adicionais.

OnErrorDeploymentType

A implantação no tipo de comportamento de erro. Os valores possíveis são LastSuccessful e SpecificDeployment.

ParametersLink

Entidade que representa a referência aos parâmetros de implantação.

Provider

Informações do provedor de recursos.

ProviderAuthorizationConsentState

O estado de consentimento de autorização do provedor.

ProviderExtendedLocation

O local estendido do provedor.

ProviderResourceType

Tipo de recurso gerenciado pelo provedor de recursos.

ProvisioningState

Indica o estado do provisionamento.

ResourceReference

O modelo de ID do recurso.

TemplateLink

Entidade que representa a referência ao modelo.

UserAssignedIdentity

Propriedades de identidade atribuídas pelo usuário

ValidationLevel

O nível de validação executado na implantação.

ZoneMapping

Alias

O tipo de alias.

Nome Tipo Description
defaultMetadata

AliasPathMetadata

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

AliasPattern

O padrão padrão para um alias.

name

string

O nome do alias.

paths

AliasPath[]

Os caminhos para um alias.

type

AliasType

O tipo do alias.

AliasPath

O tipo dos caminhos para alias.

Nome Tipo Description
apiVersions

string[]

As versões da API.

metadata

AliasPathMetadata

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

AliasPattern

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

AliasPathAttributes

Os atributos do token ao qual o caminho do alias está se referindo.

type

AliasPathTokenType

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

AliasPatternType

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

ErrorResponse

Resposta de erro
Resposta de erro comum para todas as APIs do Azure Resource Manager retornarem detalhes de erro para operações com falha. (Isso também segue o formato de resposta de erro OData.)

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

BasicDependency[]

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

DeploymentIdentity

A configuração de Identidade Gerenciada para uma implantação.

location

string

O local para armazenar os dados de implantação.

properties

DeploymentProperties

As propriedades de implantação.

tags

object

Marcas de implantação

DeploymentDiagnosticsDefinition

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

level

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

DeploymentPropertiesExtended

Propriedades de implantação.

tags

object

Marcas de implantação

type

string

O tipo da implantação.

DeploymentExtensionConfigItem

Nome Tipo Description
keyVaultReference

KeyVaultParameterReference

A referência do Azure Key Vault usada para recuperar o valor secreto da propriedade de configuração de extensão.

type

ExtensionConfigPropertyType

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,  DeploymentExtensionConfigItem>

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

DeploymentIdentityType

O tipo de identidade.

userAssignedIdentities

<string,  UserAssignedIdentity>

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

KeyVaultParameterReference

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

DebugSetting

A configuração de depuração da implantação.

expressionEvaluationOptions

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,  DeploymentExternalInputDefinition>

Definições de entrada externa, usadas por ferramentas externas para definir valores de entrada externos esperados.

externalInputs

<string,  DeploymentExternalInput>

Valores de entrada externos, usados por ferramentas externas para avaliação de parâmetros.

mode

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.

onErrorDeployment

OnErrorDeployment

A implantação no comportamento de erro.

parameters

<string,  DeploymentParameter>

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

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

TemplateLink

O URI do modelo. Use a propriedade templateLink ou a propriedade de modelo, mas não ambos.

validationLevel

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

DebugSetting

A configuração de depuração da implantação.

dependencies

Dependency[]

A lista de dependências de implantação.

diagnostics

DeploymentDiagnosticsDefinition[]

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

ErrorResponse

Resposta de erro
O erro de implantação.

extensions

DeploymentExtensionDefinition[]

As extensões usadas nesta implantação.

mode

DeploymentMode

O modo de implantação. Os valores possíveis são Incrementais e Concluídos.

onErrorDeployment

OnErrorDeploymentExtended

A implantação no comportamento de erro.

outputResources

ResourceReference[]

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

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

ProvisioningState

Indica o estado do provisionamento.

templateHash

string

O hash produzido para o modelo.

templateLink

TemplateLink

O URI que faz referência ao modelo.

timestamp

string (date-time)

O carimbo de data/hora da implantação do modelo.

validatedResources

ResourceReference[]

Matriz de recursos validados.

validationLevel

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

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorResponse[]

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

ExpressionEvaluationOptionsScopeType

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

KeyVaultReference

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

OnErrorDeploymentType

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

OnErrorDeploymentType

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

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

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

ProviderResourceType[]

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

ApiProfile[]

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

ProviderExtendedLocation[]

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

ZoneMapping[]

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

DeploymentExtensionDefinition

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.

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[]