az deployment sub
Gerencie a implantação do modelo do Azure Resource Manager no escopo da assinatura.
Comandos
| Nome | Description | Tipo | Status |
|---|---|---|---|
| az deployment sub cancel |
Cancelar uma implantação no escopo da assinatura. |
Core | GA |
| az deployment sub create |
Inicie uma implantação no escopo da assinatura. |
Core | GA |
| az deployment sub delete |
Exclua uma implantação no escopo da assinatura. |
Core | GA |
| az deployment sub export |
Exporte o modelo usado para uma implantação. |
Core | GA |
| az deployment sub list |
Listar implantações no escopo da assinatura. |
Core | GA |
| az deployment sub show |
Mostrar uma implantação no escopo da assinatura. |
Core | GA |
| az deployment sub validate |
Valide se um modelo é válido no escopo da assinatura. |
Core | GA |
| az deployment sub wait |
Coloque a CLI em um estado de espera até que uma condição de implantação seja atendida. |
Core | GA |
| az deployment sub what-if |
Execute uma operação de implantação What-If no escopo da assinatura. |
Core | GA |
az deployment sub cancel
Cancelar uma implantação no escopo da assinatura.
az deployment sub cancel --name
Exemplos
Cancelar uma implantação no escopo da assinatura.
az deployment sub cancel -n deployment01
Parâmetros Exigidos
O nome da implantação.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az deployment sub create
Inicie uma implantação no escopo da assinatura.
Especifique apenas um de --template-file FILE | --template-uri URI | --template-spec para inserir o modelo do ARM.
az deployment sub create --___location
[--confirm-with-what-if]
[--handle-extended-json-format]
[--name]
[--no-prompt {false, true}]
[--no-wait]
[--parameters]
[--proceed-if-no-change]
[--query-string]
[--template-file]
[--template-spec]
[--template-uri]
[--validation-level {Provider, ProviderNoRbac, Template}]
[--what-if]
[--what-if-exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
[--what-if-result-format {FullResourcePayloads, ResourceIdOnly}]
Exemplos
Crie uma implantação no escopo da assinatura a partir de um arquivo de modelo remoto, usando parâmetros de um arquivo JSON local.
az deployment sub create --___location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json
Crie uma implantação no escopo da assinatura a partir de um arquivo de modelo local, usando parâmetros de uma cadeia de caracteres JSON.
az deployment sub create --___location WestUS --template-file azuredeploy.json \
--parameters '{ \"policyName\": { \"value\": \"policy2\" } }'
Crie uma implantação no escopo da assinatura a partir de um modelo local, usando um arquivo de parâmetro, um arquivo de parâmetro remoto e substituindo seletivamente pares chave/valor.
az deployment sub create --___location WestUS --template-file azuredeploy.json \
--parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json
Parâmetros Exigidos
O local para armazenar os metadados de implantação.
Parâmetros Opcionais
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Instrua o comando a executar What-If de implantação antes de executar a implantação. Em seguida, ele solicita que você reconheça as alterações de recursos antes de continuar.
A opção '--handle-extended-json-format/-j' foi preterida e será removida em uma versão futura.
Suporte para lidar com conteúdo de modelo estendido, incluindo várias linhas e comentários na implantação.
O nome da implantação.
A opção para desabilitar o prompt de parâmetros ausentes para o modelo do ARM. Quando o valor for verdadeiro, o prompt que exige que os usuários forneçam o parâmetro ausente será ignorado. O valor padrão é false.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
| Valores aceitos: | false, true |
Não aguarde a conclusão da operação de execução prolongada.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Fornecer valores de parâmetro de implantação.
Os parâmetros podem ser fornecidos de um arquivo usando a sintaxe @{path}, uma cadeia de caracteres JSON ou como pares <KEY=VALUE>. Os parâmetros são avaliados em ordem, portanto, quando um valor é atribuído duas vezes, o último valor será usado. É recomendável que você forneça primeiro o arquivo de parâmetros e, em seguida, substitua seletivamente usando a sintaxe KEY=VALUE.
Instrua o comando para executar a implantação se o resultado do What-If não contiver nenhuma alteração de recurso. Aplicável quando --confirm-with-what-if está definido.
A cadeia de caracteres de consulta (um token SAS) a ser usada com o modelo-uri no caso de modelos vinculados.
O caminho para o arquivo de modelo ou arquivo Bicep.
A ID do recurso de especificação de modelo.
O URI para o arquivo de modelo.
O nível de validação da implantação. Pode ser definido como "Provedor" (o padrão), "Modelo" ou "ProviderNoRbac". Com um nível de validação de "provedor", o ARM executará a validação completa e verificará se você tem permissão suficiente para implantar todos os recursos no modelo. Com um nível de validação de "providerNoRbac", o ARM executará a validação completa, mas verificará apenas as permissões de leitura em cada recurso. Com um nível de validação de "modelo", somente a validação estática será executada: as verificações de pré-vôo e permissões serão ignoradas.
| Propriedade | Valor |
|---|---|
| Valores aceitos: | Provider, ProviderNoRbac, Template |
Instrua o comando para executar a implantação de What-If.
Lista separada por espaço de tipos de alteração de recursos a serem excluídos dos resultados What-If. Aplicável quando --confirm-with-what-if está definido.
| Propriedade | Valor |
|---|---|
| Valores aceitos: | Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported |
O formato de resultados What-If. Aplicável quando --confirm-with-what-if é definido.
| Propriedade | Valor |
|---|---|
| Valor padrão: | FullResourcePayloads |
| Valores aceitos: | FullResourcePayloads, ResourceIdOnly |
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az deployment sub delete
Exclua uma implantação no escopo da assinatura.
az deployment sub delete --name
[--no-wait]
Exemplos
Exclua uma implantação no escopo da assinatura.
az deployment sub delete -n deployment01
Parâmetros Exigidos
O nome da implantação.
Parâmetros Opcionais
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Não aguarde a conclusão da operação de execução prolongada.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az deployment sub export
Exporte o modelo usado para uma implantação.
az deployment sub export --name
Exemplos
Exporte o modelo usado para uma implantação no escopo da assinatura.
az deployment sub export --name MyDeployment
Parâmetros Exigidos
O nome da implantação.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az deployment sub list
Listar implantações no escopo da assinatura.
az deployment sub list [--filter]
Exemplos
Listar implantações no escopo da assinatura.
az deployment sub list
Parâmetros Opcionais
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Expressão de filtro usando a notação OData. Você pode usar --filter "provisioningState eq '{state}'" para filtrar provisioningState. Para obter mais informações, visite https://learn.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parameters.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az deployment sub show
Mostrar uma implantação no escopo da assinatura.
az deployment sub show --name
Exemplos
Mostrar uma implantação no escopo da assinatura.
az deployment sub show -n deployment01
Parâmetros Exigidos
O nome da implantação.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az deployment sub validate
Valide se um modelo é válido no escopo da assinatura.
Especifique apenas um de --template-file FILE | --template-uri URI | --template-spec para inserir o modelo do ARM.
az deployment sub validate --___location
[--handle-extended-json-format]
[--name]
[--no-prompt {false, true}]
[--parameters]
[--query-string]
[--template-file]
[--template-spec]
[--template-uri]
[--validation-level {Provider, ProviderNoRbac, Template}]
Exemplos
Valide se um modelo é válido no escopo da assinatura.
az deployment sub validate --___location westus2 --template-file {template-file}
Valide se um modelo é válido no escopo da assinatura. (autogenerated)
az deployment sub validate --___location westus2 --parameters MyValue=This MyArray=@array.json --template-file azuredeploy.json
Parâmetros Exigidos
O local para armazenar os metadados de implantação.
Parâmetros Opcionais
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
A opção '--handle-extended-json-format/-j' foi preterida e será removida em uma versão futura.
Suporte para lidar com conteúdo de modelo estendido, incluindo várias linhas e comentários na implantação.
O nome da implantação.
A opção para desabilitar o prompt de parâmetros ausentes para o modelo do ARM. Quando o valor for verdadeiro, o prompt que exige que os usuários forneçam o parâmetro ausente será ignorado. O valor padrão é false.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
| Valores aceitos: | false, true |
Fornecer valores de parâmetro de implantação.
Os parâmetros podem ser fornecidos de um arquivo usando a sintaxe @{path}, uma cadeia de caracteres JSON ou como pares <KEY=VALUE>. Os parâmetros são avaliados em ordem, portanto, quando um valor é atribuído duas vezes, o último valor será usado. É recomendável que você forneça primeiro o arquivo de parâmetros e, em seguida, substitua seletivamente usando a sintaxe KEY=VALUE.
A cadeia de caracteres de consulta (um token SAS) a ser usada com o modelo-uri no caso de modelos vinculados.
O caminho para o arquivo de modelo ou arquivo Bicep.
A ID do recurso de especificação de modelo.
O URI para o arquivo de modelo.
O nível de validação da implantação. Pode ser definido como "Provedor" (o padrão), "Modelo" ou "ProviderNoRbac". Com um nível de validação de "provedor", o ARM executará a validação completa e verificará se você tem permissão suficiente para implantar todos os recursos no modelo. Com um nível de validação de "providerNoRbac", o ARM executará a validação completa, mas verificará apenas as permissões de leitura em cada recurso. Com um nível de validação de "modelo", somente a validação estática será executada: as verificações de pré-vôo e permissões serão ignoradas.
| Propriedade | Valor |
|---|---|
| Valores aceitos: | Provider, ProviderNoRbac, Template |
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az deployment sub wait
Coloque a CLI em um estado de espera até que uma condição de implantação seja atendida.
az deployment sub wait --name
[--created]
[--custom]
[--deleted]
[--exists]
[--interval]
[--timeout]
[--updated]
Exemplos
Coloque a CLI em um estado de espera até que uma condição de implantação seja atendida. (autogenerated)
az deployment sub wait --created --name MyDeployment
Parâmetros Exigidos
O nome da implantação.
Parâmetros Opcionais
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Aguarde até ser criado com 'provisioningState' em 'Succeeded'.
| Propriedade | Valor |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Valor padrão: | False |
Aguarde até que a condição atenda a uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
| Propriedade | Valor |
|---|---|
| Parameter group: | Wait Condition Arguments |
Aguarde até ser excluído.
| Propriedade | Valor |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Valor padrão: | False |
Aguarde até que o recurso exista.
| Propriedade | Valor |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Valor padrão: | False |
Intervalo de sondagem em segundos.
| Propriedade | Valor |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Valor padrão: | 30 |
Espera máxima em segundos.
| Propriedade | Valor |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Valor padrão: | 3600 |
Aguarde até que seja atualizado com provisioningState em 'Succeeded'.
| Propriedade | Valor |
|---|---|
| Parameter group: | Wait Condition Arguments |
| Valor padrão: | False |
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az deployment sub what-if
Execute uma operação de implantação What-If no escopo da assinatura.
Especifique apenas um de --template-file FILE | --template-uri URI | --template-spec para inserir o modelo do ARM.
az deployment sub what-if --___location
[--exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
[--name]
[--no-pretty-print]
[--no-prompt {false, true}]
[--parameters]
[--query-string]
[--result-format {FullResourcePayloads, ResourceIdOnly}]
[--template-file]
[--template-spec]
[--template-uri]
[--validation-level {Provider, ProviderNoRbac, Template}]
Exemplos
Execute uma operação de implantação What-If em uma assinatura.
az deployment sub what-if --___location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json
Execute uma operação de implantação What-If em uma assinatura com o formato ResourceIdOnly.
az deployment sub what-if --___location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly
Execute uma operação de implantação What-If em uma assinatura sem imprimir o resultado.
az deployment sub what-if --___location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --no-pretty-print
Parâmetros Exigidos
O local para armazenar os metadados da operação What-If implantação.
Parâmetros Opcionais
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Lista separada por espaço de tipos de alteração de recursos a serem excluídos dos resultados What-If.
| Propriedade | Valor |
|---|---|
| Valores aceitos: | Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported |
O nome da implantação.
Desabilite a impressão bonita para resultados What-If. Quando definido, o tipo de formato de saída será usado.
A opção para desabilitar o prompt de parâmetros ausentes para o modelo do ARM. Quando o valor for verdadeiro, o prompt que exige que os usuários forneçam o parâmetro ausente será ignorado. O valor padrão é false.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
| Valores aceitos: | false, true |
Fornecer valores de parâmetro de implantação.
Os parâmetros podem ser fornecidos de um arquivo usando a sintaxe @{path}, uma cadeia de caracteres JSON ou como pares <KEY=VALUE>. Os parâmetros são avaliados em ordem, portanto, quando um valor é atribuído duas vezes, o último valor será usado. É recomendável que você forneça primeiro o arquivo de parâmetros e, em seguida, substitua seletivamente usando a sintaxe KEY=VALUE.
A cadeia de caracteres de consulta (um token SAS) a ser usada com o modelo-uri no caso de modelos vinculados.
O formato de resultados What-If.
| Propriedade | Valor |
|---|---|
| Valor padrão: | FullResourcePayloads |
| Valores aceitos: | FullResourcePayloads, ResourceIdOnly |
O caminho para o arquivo de modelo ou arquivo Bicep.
A ID do recurso de especificação de modelo.
O URI para o arquivo de modelo.
O nível de validação da implantação. Pode ser definido como "Provedor" (o padrão), "Modelo" ou "ProviderNoRbac". Com um nível de validação de "provedor", o ARM executará a validação completa e verificará se você tem permissão suficiente para implantar todos os recursos no modelo. Com um nível de validação de "providerNoRbac", o ARM executará a validação completa, mas verificará apenas as permissões de leitura em cada recurso. Com um nível de validação de "modelo", somente a validação estática será executada: as verificações de pré-vôo e permissões serão ignoradas.
| Propriedade | Valor |
|---|---|
| Valores aceitos: | Provider, ProviderNoRbac, Template |
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |