Partilhar via

az group deployment

  • Preterido
  • Referência

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

Gerencie implantações do Azure Resource Manager.

Comandos

Name Description Tipo Status
az group deployment cancel

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

 Principal Preterido
az group deployment create

Inicie uma implantação.

 Principal Preterido
az group deployment delete

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

 Principal Preterido
az group deployment export

Exporte o modelo usado para uma implantação.

 Principal Preterido
az group deployment list

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

 Principal Preterido
az group deployment operation

Gerencie as operações de implantação.

 Principal Preterido
az group deployment operation list

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

 Principal Preterido
az group deployment operation show

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

 Principal Preterido
az group deployment show

Obtém uma implantação.

 Principal Preterido
az group deployment validate

Valide se um modelo está sintaticamente correto.

 Principal Preterido
az group deployment wait

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

 Principal Preterido

az group deployment cancel

Editar
Preterido

Este comando foi implicitamente preterido 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 Accepted ou Running. 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 Obrigatórios

--name -n

O nome da implantação.

--resource-group -g

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

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

az group deployment create

Editar
Preterido

Este comando foi implicitamente preterido 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 Obrigatórios

--resource-group -g

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

Subscrições auxiliares que serão utilizadas durante a implementação entre inquilinos.

--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 Concluído (remover recursos extras do grupo de recursos).

Valores aceites: Complete, Incremental
Default value: Incremental
--name -n

O nome da implantação. Padrão para 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 predefinido é false.

Valores aceites: false, true
Default value: False
--no-wait

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

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 @{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 seu 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 no 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 de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

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

az group deployment delete

Editar
Preterido

Este comando foi implicitamente preterido 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á em execução 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. Esta é 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 Location retorna um status de 202. Quando o processo termina, o URI no cabeçalho Location retorna um status de 204 no ê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 Obrigatórios

--name -n

O nome da implantação.

--resource-group -g

o 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 espere que a operação de longa duração termine.

Default value: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

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

az group deployment export

Editar
Preterido

Este comando foi implicitamente preterido 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'.

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

--name -n

O nome da implantação.

--resource-group -g

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

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

az group deployment list

Editar
Preterido

Este comando foi implicitamente preterido 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'.

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

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

Parâmetros Obrigatórios

--resource-group -g

o 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 aplicar 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 de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

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

az group deployment show

Editar
Preterido

Este comando foi implicitamente preterido 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 Obrigatórios

--name -n

O nome da implantação.

--resource-group -g

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

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

az group deployment validate

Editar
Preterido

Este comando foi implicitamente preterido 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 Obrigatórios

--resource-group -g

o 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 Concluído (remover recursos extras do grupo de recursos).

Valores aceites: Complete, Incremental
Default value: 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 predefinido é false.

Valores aceites: false, true
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 @{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 seu 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 no 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 de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

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

az group deployment wait

Editar
Preterido

Este comando foi implicitamente preterido 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 Obrigatórios

--name -n

O nome da implantação.

--resource-group -g

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

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

--deleted

Aguarde até ser excluído.

Default value: False
--exists

Aguarde até que o recurso exista.

Default value: False
--interval

Intervalo de sondagem em segundos.

Default value: 30
--timeout

Espera máxima em segundos.

Default value: 3600
--updated

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

Default value: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

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