az deployment sub

Gerencie a implantação do modelo do Azure Resource Manager no escopo da assinatura.

Comandos

Name	Description	Tipo	Status
az deployment sub cancel	Cancelar uma implantação no escopo da assinatura.	Core	disponibilidade geral
az deployment sub create	Inicie uma implantação no escopo da assinatura.	Core	disponibilidade geral
az deployment sub delete	Exclua uma implantação no escopo da assinatura.	Core	disponibilidade geral
az deployment sub export	Exporte o modelo usado para uma implantação.	Core	disponibilidade geral
az deployment sub list	Listar implantações no escopo da assinatura.	Core	disponibilidade geral
az deployment sub show	Mostrar uma implantação no escopo da assinatura.	Core	disponibilidade geral
az deployment sub validate	Valide se um modelo é válido no escopo da assinatura.	Core	disponibilidade geral
az deployment sub wait	Coloque a CLI em um estado de espera até que uma condição de implantação seja atendida.	Core	disponibilidade geral
az deployment sub what-if	Execute uma operação de What-If de implantação no escopo da assinatura.	Core	disponibilidade geral

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 Obrigatórios

--name -n

O nome da implantação.

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False

az deployment sub create

Inicie uma implantação no escopo da assinatura.

Por favor, especifique apenas um dos --template-file FILE | --template-uri URI | --template-spec para inserir o modelo 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 Obrigatórios

--location -l

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--confirm-with-what-if -c

Instrua o comando para executar o 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 que elas continuem.

--handle-extended-json-format -j

Preterido

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.

--name -n

O nome da implantação.

--no-prompt

A opção para desativar o prompt de parâmetros ausentes para o modelo ARM. Quando o valor for true, o prompt que exige que os usuários forneçam o parâmetro ausente será ignorado. O valor padrão é false.

Propriedade	Valor
Default value:	False
Valores aceites:	false, true

--no-wait

Não espere que a operação de longa duração termine.

Propriedade	Valor
Default value:	False

--parameters -p

Forneça valores de parâmetros de implantação.

Os parâmetros podem ser fornecidos a partir 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 seu arquivo de parâmetros primeiro e, em seguida, substitua seletivamente usando a sintaxe KEY=VALUE.

--proceed-if-no-change

Instrua o comando para executar a implantação se o resultado da What-If não contiver alterações de recursos. Aplicável quando --confirm-with-what-if está definido.

--query-string -q

A cadeia de caracteres de consulta (um token SAS) a ser usada com o template-uri no caso de modelos vinculados.

--template-file -f

O caminho para o arquivo de modelo ou arquivo Bicep.

--template-spec -s

A id do recurso de especificação do modelo.

--template-uri -u

O URI para o arquivo de modelo.

--validation-level

O nível de validação de implantação. Pode ser definido como "Provider" (o padrão), "Template" 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", apenas a validação estática será realizada: as verificações de comprovação e permissões serão ignoradas.

Propriedade	Valor
Valores aceites:	Provider, ProviderNoRbac, Template

--what-if -w

Instrua o comando para executar o What-If.

--what-if-exclude-change-types -x

Lista separada por espaço dos 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 aceites:	Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported

--what-if-result-format -r

O formato dos resultados What-If. Aplicável quando --confirm-with-what-if é definido.

Propriedade	Valor
Default value:	FullResourcePayloads
Valores aceites:	FullResourcePayloads, ResourceIdOnly

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	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 Obrigatórios

--name -n

O nome da implantação.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--no-wait

Não espere que a operação de longa duração termine.

Propriedade	Valor
Default value:	False

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	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 Obrigatórios

--name -n

O nome da implantação.

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--filter

Pré-visualizar

Filtrar expressão usando 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 de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	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 Obrigatórios

--name -n

O nome da implantação.

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False

az deployment sub validate

Valide se um modelo é válido no escopo da assinatura.

Por favor, especifique apenas um dos --template-file FILE | --template-uri URI | --template-spec para inserir o modelo 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 Obrigatórios

--location -l

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--handle-extended-json-format -j

Preterido

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.

--name -n

O nome da implantação.

--no-prompt

A opção para desativar o prompt de parâmetros ausentes para o modelo ARM. Quando o valor for true, o prompt que exige que os usuários forneçam o parâmetro ausente será ignorado. O valor padrão é false.

Propriedade	Valor
Default value:	False
Valores aceites:	false, true

--parameters -p

Forneça valores de parâmetros de implantação.

Os parâmetros podem ser fornecidos a partir 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 seu arquivo de parâmetros primeiro e, em seguida, substitua seletivamente usando a sintaxe KEY=VALUE.

--query-string -q

A cadeia de caracteres de consulta (um token SAS) a ser usada com o template-uri no caso de modelos vinculados.

--template-file -f

O caminho para o arquivo de modelo ou arquivo Bicep.

--template-spec -s

A id do recurso de especificação do modelo.

--template-uri -u

O URI para o arquivo de modelo.

--validation-level

O nível de validação de implantação. Pode ser definido como "Provider" (o padrão), "Template" 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", apenas a validação estática será realizada: as verificações de comprovação e permissões serão ignoradas.

Propriedade	Valor
Valores aceites:	Provider, ProviderNoRbac, Template

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	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 Obrigatórios

--name -n

O nome da implantação.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--created

Aguarde até ser criado com 'provisioningState' em 'Succeeded'.

Propriedade	Valor
Grupo de parâmetros:	Wait Condition Arguments
Default value:	False

--custom

Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Propriedade	Valor
Grupo de parâmetros:	Wait Condition Arguments

--deleted

Aguarde até ser excluído.

Propriedade	Valor
Grupo de parâmetros:	Wait Condition Arguments
Default value:	False

--exists

Aguarde até que o recurso exista.

Propriedade	Valor
Grupo de parâmetros:	Wait Condition Arguments
Default value:	False

--interval

Intervalo de sondagem em segundos.

Propriedade	Valor
Grupo de parâmetros:	Wait Condition Arguments
Default value:	30

--timeout

Espera máxima em segundos.

Propriedade	Valor
Grupo de parâmetros:	Wait Condition Arguments
Default value:	3600

--updated

Aguarde até ser atualizado com provisioningState em 'Succeeded'.

Propriedade	Valor
Grupo de parâmetros:	Wait Condition Arguments
Default value:	False

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False

az deployment sub what-if

Execute uma operação de What-If de implantação no escopo da assinatura.

Por favor, especifique apenas um dos --template-file FILE | --template-uri URI | --template-spec para inserir o modelo 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 What-If de implantação em uma assinatura.

az deployment sub what-if --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Execute uma operação de What-If de implantação 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 What-If de implantação 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 Obrigatórios

--location -l

O local para armazenar a implantação What-If metadados de operação.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--exclude-change-types -x

Lista separada por espaço dos tipos de alteração de recursos a serem excluídos dos resultados What-If.

Propriedade	Valor
Valores aceites:	Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported

--name -n

O nome da implantação.

--no-pretty-print

Desative a impressão bonita para What-If resultados. Quando definido, o tipo de formato de saída será usado.

--no-prompt

A opção para desativar o prompt de parâmetros ausentes para o modelo ARM. Quando o valor for true, o prompt que exige que os usuários forneçam o parâmetro ausente será ignorado. O valor padrão é false.

Propriedade	Valor
Default value:	False
Valores aceites:	false, true

--parameters -p

Forneça valores de parâmetros de implantação.

Os parâmetros podem ser fornecidos a partir 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 seu arquivo de parâmetros primeiro e, em seguida, substitua seletivamente usando a sintaxe KEY=VALUE.

--query-string -q

A cadeia de caracteres de consulta (um token SAS) a ser usada com o template-uri no caso de modelos vinculados.

--result-format -r

O formato dos resultados What-If.

Propriedade	Valor
Default value:	FullResourcePayloads
Valores aceites:	FullResourcePayloads, ResourceIdOnly

--template-file -f

O caminho para o arquivo de modelo ou arquivo Bicep.

--template-spec -s

A id do recurso de especificação do modelo.

--template-uri -u

O URI para o arquivo de modelo.

--validation-level

O nível de validação de implantação. Pode ser definido como "Provider" (o padrão), "Template" 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", apenas a validação estática será realizada: as verificações de comprovação e permissões serão ignoradas.

Propriedade	Valor
Valores aceites:	Provider, ProviderNoRbac, Template

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False