az group deployment

  • Preterido
  • Referência

Esse grupo de comandos foi preterido e será removido em uma versão futura. Em vez disso, use 'grupo de implantação'.

Gerenciar implantações do Gerenciador de Recursos do Azure.

Comandos

Nome Description Tipo Status
az group deployment cancel

Cancela uma implantação de modelo em execução no momento.

 Núcleo Preterido
az group deployment create

Inicie uma implantação.

 Núcleo Preterido
az group deployment delete

Exclui uma implantação do histórico de implantação.

 Núcleo Preterido
az group deployment export

Exportar o modelo usado para uma implantação.

 Núcleo Preterido
az group deployment list

Obter todas as implantações de um grupo de recursos.

 Núcleo Preterido
az group deployment operation

Gerenciar operações de implantação.

 Núcleo Preterido
az group deployment operation list

Obtém todas as operações de implantação para uma implantação.

 Núcleo Preterido
az group deployment operation show

Obtenha a operação de uma implantação.

 Núcleo Preterido
az group deployment show

Obtém uma implantação.

 Núcleo Preterido
az group deployment validate

Valide se um modelo está sintaticamente correto.

 Núcleo Preterido
az group deployment wait

Coloque a CLI em um estado de espera até que uma condição de implantação seja atendida.

 Núcleo Preterido

az group deployment cancel

Editar
Preterido

Esse comando foi preterido implicitamente porque o grupo de comandos 'implantação de grupo' foi preterido e será removido em uma versão futura. Em vez disso, use 'grupo de implantação'.

Cancela uma implantação de modelo em execução no momento.

Você pode cancelar uma implantação somente se o provisioningState for Aceito ou Em execução. Depois que a implantação for cancelada, o provisioningState será definido como Canceled. O cancelamento de uma implantação de modelo interrompe a implantação de modelo em execução no momento e deixa o grupo de recursos parcialmente implantado.

az group deployment cancel --name
                           --resource-group

Parâmetros Exigidos

--name -n

O nome da implantação.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az group deployment create

Editar
Preterido

Esse comando foi preterido implicitamente porque o grupo de comandos 'implantação de grupo' foi preterido e será removido em uma versão futura. Em vez disso, use 'grupo de implantação'.

Inicie uma implantação.

az group deployment create --resource-group
                           [--aux-subs]
                           [--aux-tenants]
                           [--handle-extended-json-format]
                           [--mode {Complete, Incremental}]
                           [--name]
                           [--no-prompt {false, true}]
                           [--no-wait]
                           [--parameters]
                           [--rollback-on-error]
                           [--template-file]
                           [--template-uri]

Exemplos

Crie uma implantação a partir de um arquivo de modelo remoto, usando parâmetros de um arquivo JSON local.

az group deployment create -g MyResourceGroup --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Crie uma implantação a partir de um arquivo de modelo local, usando parâmetros de uma cadeia de caracteres JSON.

az group deployment create -g MyResourceGroup --template-file azuredeploy.json \
    --parameters "{ \"location\": { \"value\": \"westus\" } }"

Crie uma implantação a partir de um modelo local, usando um arquivo de parâmetro local, um arquivo de parâmetro remoto e substituindo seletivamente pares chave/valor.

az group deployment create -g MyResourceGroup --template-file azuredeploy.json \
    --parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

Parâmetros Exigidos

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--aux-subs
Preterido

A opção '--aux-subs' foi preterida e será removida em uma versão futura. Em vez disso, use '--aux-tenants'.

Assinaturas auxiliares que serão usadas durante a implantação entre locatários.

--aux-tenants

Locatários auxiliares que serão usados durante a implantação entre locatários.

--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.

--mode

Incremental (adicionar apenas recursos ao grupo de recursos) ou Concluir (remover recursos extras do grupo de recursos).

Valores aceitos: Complete, Incremental
Valor padrão: Incremental
--name -n

O nome da implantação. O padrão é o nome base do arquivo de modelo.

--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.

Valores aceitos: false, true
Valor padrão: False
--no-wait

Não aguarde a conclusão da operação de execução longa.

Valor padrão: False
--parameters -p

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

Os parâmetros podem ser fornecidos de um arquivo usando a @{path} sintaxe, 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 o arquivo de parâmetros primeiro e, em seguida, substitua seletivamente usando a sintaxe KEY=VALUE.

--rollback-on-error

O nome de uma implantação para reverter para o erro ou usar como um sinalizador para reverter para a última implantação bem-sucedida.

--template-file -f

Um caminho para um arquivo de modelo ou arquivo Bicep no sistema de arquivos.

--template-uri -u

Um uri para um arquivo de modelo remoto.

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az group deployment delete

Editar
Preterido

Esse comando foi preterido implicitamente porque o grupo de comandos 'implantação de grupo' foi preterido e será removido em uma versão futura. Em vez disso, use 'grupo de implantação'.

Exclui uma implantação do histórico de implantação.

Uma implantação de modelo que está sendo executada no momento não pode ser excluída. A exclusão de uma implantação de modelo remove as operações de implantação associadas. A exclusão de uma implantação de modelo não afeta o estado do grupo de recursos. Essa é uma operação assíncrona que retorna um status de 202 até que a implantação do modelo seja excluída com êxito. O cabeçalho de resposta Location contém o URI usado para obter o status do processo. Enquanto o processo está em execução, uma chamada para o URI no cabeçalho Local retorna um status de 202. Quando o processo for concluído, o URI no cabeçalho Location retornará um status de 204 em caso de êxito. Se a solicitação assíncrona falhar, o URI no cabeçalho Location retornará um código de status de nível de erro.

az group deployment delete --name
                           --resource-group
                           [--no-wait]

Parâmetros Exigidos

--name -n

O nome da implantação.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--no-wait

Não aguarde a conclusão da operação de execução longa.

Valor padrão: False
Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az group deployment export

Editar
Preterido

Esse comando foi preterido implicitamente porque o grupo de comandos 'implantação de grupo' foi preterido e será removido em uma versão futura. Em vez disso, use 'grupo de implantação'.

Exportar o modelo usado para uma implantação.

az group deployment export --name
                           --resource-group

Exemplos

Exportar o modelo usado para uma implantação. (gerado automaticamente)

az group deployment export --name MyDeployment --resource-group MyResourceGroup

Parâmetros Exigidos

--name -n

O nome da implantação.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az group deployment list

Editar
Preterido

Esse comando foi preterido implicitamente porque o grupo de comandos 'implantação de grupo' foi preterido e será removido em uma versão futura. Em vez disso, use 'grupo de implantação'.

Obter todas as implantações de um grupo de recursos.

az group deployment list --resource-group
                         [--filter]
                         [--top]

Parâmetros Exigidos

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--filter

O filtro a ser aplicado na operação. Por exemplo, você pode usar $filter=provisioningState eq '{state}'. O valor padrão é Nenhum.

--top

O número de resultados a obter. Se null for passado, retornará todas as implantações. O valor padrão é Nenhum.

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az group deployment show

Editar
Preterido

Esse comando foi preterido implicitamente porque o grupo de comandos 'implantação de grupo' foi preterido e será removido em uma versão futura. Em vez disso, use 'grupo de implantação'.

Obtém uma implantação.

az group deployment show --name
                         --resource-group

Parâmetros Exigidos

--name -n

O nome da implantação.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az group deployment validate

Editar
Preterido

Esse comando foi preterido implicitamente porque o grupo de comandos 'implantação de grupo' foi preterido e será removido em uma versão futura. Em vez disso, use 'grupo de implantação'.

Valide se um modelo está sintaticamente correto.

az group deployment validate --resource-group
                             [--handle-extended-json-format]
                             [--mode {Complete, Incremental}]
                             [--no-prompt {false, true}]
                             [--parameters]
                             [--rollback-on-error]
                             [--template-file]
                             [--template-uri]

Exemplos

Valide se um modelo está sintaticamente correto. (gerado automaticamente)

az group deployment validate --parameters "{ \"location\": { \"value\": \"westus\" } }" \
    --resource-group MyResourceGroup --template-file storage.json

Parâmetros Exigidos

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--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.

--mode

Incremental (adicionar apenas recursos ao grupo de recursos) ou Concluir (remover recursos extras do grupo de recursos).

Valores aceitos: Complete, Incremental
Valor padrão: Incremental
--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.

Valores aceitos: false, true
Valor padrão: False
--parameters -p

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

Os parâmetros podem ser fornecidos de um arquivo usando a @{path} sintaxe, 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 o arquivo de parâmetros primeiro e, em seguida, substitua seletivamente usando a sintaxe KEY=VALUE.

--rollback-on-error

O nome de uma implantação para reverter para o erro ou usar como um sinalizador para reverter para a última implantação bem-sucedida.

--template-file -f

Um caminho para um arquivo de modelo ou arquivo Bicep no sistema de arquivos.

--template-uri -u

Um uri para um arquivo de modelo remoto.

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az group deployment wait

Editar
Preterido

Esse comando foi preterido implicitamente porque o grupo de comandos 'implantação de grupo' foi preterido e será removido em uma versão futura. Em vez disso, use 'grupo de implantação'.

Coloque a CLI em um estado de espera até que uma condição de implantação seja atendida.

az group deployment wait --name
                         --resource-group
                         [--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 group deployment wait --name MyDeployment --resource-group MyResourceGroup --updated

Coloque a CLI em um estado de espera até que uma condição de implantação seja atendida. (gerado automaticamente)

az group deployment wait --created --name MyDeployment --resource-group MyResourceGroup

Parâmetros Exigidos

--name -n

O nome da implantação.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--created

Aguarde até criar com 'provisioningState' em 'Succeeded'.

Valor padrão: False
--custom

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

--deleted

Aguarde até ser excluído.

Valor padrão: False
--exists

Aguarde até que o recurso exista.

Valor padrão: False
--interval

Intervalo de sondagem em segundos.

Valor padrão: 30
--timeout

Espera máxima em segundos.

Valor padrão: 3600
--updated

Aguarde até que seja atualizado com provisioningState em 'Succeeded'.

Valor padrão: False
Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.