az deployment sub
Gerenciar a implantação de 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. |
Núcleo | GA |
az deployment sub create |
Inicie uma implantação no escopo da assinatura. |
Núcleo | GA |
az deployment sub delete |
Exclua uma implantação no escopo da assinatura. |
Núcleo | GA |
az deployment sub export |
Exporte o modelo usado para uma implantação. |
Núcleo | GA |
az deployment sub list |
Listar implantações no escopo da assinatura. |
Núcleo | GA |
az deployment sub show |
Mostrar uma implantação no escopo da assinatura. |
Núcleo | GA |
az deployment sub validate |
Valide se um modelo é válido no escopo da assinatura. |
Núcleo | GA |
az deployment sub wait |
Coloque a CLI em um estado de espera até que uma condição de implantação seja atendida. |
Núcleo | GA |
az deployment sub what-if |
Execute uma operação de implantação What-If no escopo da assinatura. |
Núcleo | 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.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar erros, suprimindo avisos.
Formato de saída.
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.
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]
[--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
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.
Não aguarde a conclusão da operação de execução prolongada.
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.
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.
O formato de resultados What-If. Aplicável quando --confirm-with-what-if
é definido.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar erros, suprimindo avisos.
Formato de saída.
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.
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
Não aguarde a conclusão da operação de execução prolongada.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar erros, suprimindo avisos.
Formato de saída.
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.
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.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar erros, suprimindo avisos.
Formato de saída.
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.
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
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.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar erros, suprimindo avisos.
Formato de saída.
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.
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.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar erros, suprimindo avisos.
Formato de saída.
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.
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]
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. (gerado automaticamente)
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
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.
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.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar erros, suprimindo avisos.
Formato de saída.
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.
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. (gerado automaticamente)
az deployment sub wait --created --name MyDeployment
Parâmetros Exigidos
O nome da implantação.
Parâmetros Opcionais
Aguarde até ser criado com 'provisioningState' em 'Succeeded'.
Aguarde até que a condição atenda a uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Aguarde até ser excluído.
Aguarde até que o recurso exista.
Intervalo de sondagem em segundos.
Espera máxima em segundos.
Aguarde até que seja atualizado com provisioningState em 'Succeeded'.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar erros, suprimindo avisos.
Formato de saída.
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.
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]
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
Lista separada por espaço de tipos de alteração de recursos a serem excluídos dos resultados What-If.
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.
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.
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.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar erros, suprimindo avisos.
Formato de saída.
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.