Compartilhar via

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 Azure Resource Manager.

Comandos

Nome Description Tipo Status
az group deployment cancel

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

 Núcleo Deprecado
az group deployment create

Inicie uma implantação.

 Núcleo Deprecado
az group deployment delete

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

 Núcleo Deprecado
az group deployment export

Exporte o modelo usado para uma implantação.

 Núcleo Deprecado
az group deployment list

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

 Núcleo Deprecado
az group deployment operation

Gerenciar operações de implantação.

 Núcleo Deprecado
az group deployment operation list

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

 Núcleo Deprecado
az group deployment operation show

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

 Núcleo Deprecado
az group deployment show

Obtém uma implantação.

 Núcleo Deprecado
az group deployment validate

Valide se um modelo está sintaticamente correto.

 Núcleo Deprecado
az group deployment wait

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

 Núcleo Deprecado

az group deployment cancel

Editar
Preterido

Esse comando foi substituído implicitamente porque a "implantação de grupo" do grupo de comandos foi preterida e será removida 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ê só poderá cancelar uma implantação se o provisioningState for Accepted ou Running. Depois que a implantação é cancelada, o provisioningState é definido como Cancelado. 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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az group deployment create

Editar
Preterido

Esse comando foi substituído implicitamente porque a "implantação de grupo" do grupo de comandos foi preterida e será removida 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 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 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 (adicione apenas recursos ao grupo de recursos) ou Concluído (remova recursos extras do grupo de recursos).

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

O nome da implantação. Padrão para o nome base do arquivo de modelo.

--no-prompt

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.

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

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

Valor padrão: False
--parameters -p

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.

--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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az group deployment delete

Editar
Preterido

Esse comando foi substituído implicitamente porque a "implantação de grupo" do grupo de comandos foi preterida e será removida 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á em execução no momento não pode ser excluída. Excluir uma implantação de modelo remove as operações de implantação associadas. Excluir 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 Local 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 é concluído, o URI no cabeçalho Local retorna um status de 204 com êxito. Se a solicitação assíncrona falhar, o URI no cabeçalho Local retornará um código de status no 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 prolongada.

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

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az group deployment export

Editar
Preterido

Esse comando foi substituído implicitamente porque a "implantação de grupo" do grupo de comandos foi preterida e será removida em uma versão futura. Em vez disso, use "grupo de implantação".

Exporte o modelo usado para uma implantação.

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

Exemplos

Exporte 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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az group deployment list

Editar
Preterido

Esse comando foi substituído implicitamente porque a "implantação de grupo" do grupo de comandos foi preterida e será removida em uma versão futura. Em vez disso, use "grupo de implantação".

Obtenha 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 é None.

--top

O número de resultados a serem obtidos. Se nulo for passado, retornará todas as implantações. O valor padrão é None.

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az group deployment show

Editar
Preterido

Esse comando foi substituído implicitamente porque a "implantação de grupo" do grupo de comandos foi preterida e será removida 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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az group deployment validate

Editar
Preterido

Esse comando foi substituído implicitamente porque a "implantação de grupo" do grupo de comandos foi preterida e será removida 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 (adicione apenas recursos ao grupo de recursos) ou Concluído (remova recursos extras do grupo de recursos).

Valores aceitos: Complete, Incremental
Valor padrão: Incremental
--no-prompt

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.

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

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.

--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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az group deployment wait

Editar
Preterido

Esse comando foi substituído implicitamente porque a "implantação de grupo" do grupo de comandos foi preterida e será removida 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é ser criado com 'provisioningState' em 'Succeeded'.

Valor padrão: False
--custom

Aguarde até que a condição atenda 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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.