Compartilhar via

az image builder

  • Referência

Gerenciar e criar modelos do construtor de imagens.

Comandos

Nome Description Tipo Status
az image builder cancel

Cancele o build de imagem de execução longa com base no modelo de imagem.

 Núcleo GA
az image builder create

Crie um modelo de construtor de imagens.

 Núcleo GA
az image builder customizer

Gerenciar personalizadores de modelo do construtor de imagens.

 Núcleo GA
az image builder customizer add

Adicione um personalizador do construtor de imagens a um modelo do construtor de imagens.

 Núcleo GA
az image builder customizer clear

Remova todos os personalizadores do construtor de imagens de um modelo de construtor de imagens.

 Núcleo GA
az image builder customizer remove

Remova um personalizador do construtor de imagens de um modelo de construtor de imagens.

 Núcleo GA
az image builder delete

Exclua o modelo do construtor de imagens.

 Núcleo GA
az image builder error-handler

Gerenciar o manipulador de erros de modelo do construtor de imagens.

 Núcleo GA
az image builder error-handler add

Adicione o manipulador de erros a um modelo de construtor de imagens existente.

 Núcleo GA
az image builder error-handler remove

Remova o manipulador de erros de um modelo de construtor de imagens existente.

 Núcleo GA
az image builder error-handler show

Mostrar o manipulador de erros de um modelo de construtor de imagens existente.

 Núcleo GA
az image builder identity

Gerenciar identidades de um modelo de construtor de imagens.

 Núcleo GA
az image builder identity assign

Adicione identidades gerenciadas a um modelo de construtor de imagens existente. Atualmente, há suporte para apenas uma identidade de usuário.

 Núcleo GA
az image builder identity remove

Remova identidades gerenciadas de um modelo de construtor de imagens existente.

 Núcleo GA
az image builder identity show

Exibir identidades gerenciadas de um modelo de construtor de imagens.

 Núcleo GA
az image builder list

Listar modelos do construtor de imagens.

 Núcleo GA
az image builder optimizer

Gerenciar o otimizador de modelo do construtor de imagens.

 Núcleo GA
az image builder optimizer add

Adicione otimizador a um modelo de construtor de imagens existente.

 Núcleo GA
az image builder optimizer remove

Remova o otimizador de um modelo de construtor de imagens existente.

 Núcleo GA
az image builder optimizer show

Mostrar o otimizador de um modelo de construtor de imagens existente.

 Núcleo GA
az image builder optimizer update

Atualize um otimizador de um modelo de construtor de imagens existente.

 Núcleo GA
az image builder output

Gerenciar distribuidores de saída de modelo do construtor de imagens.

 Núcleo GA
az image builder output add

Adicione um distribuidor de saída do construtor de imagens a um modelo do construtor de imagens.

 Núcleo GA
az image builder output clear

Remova todos os distribuidores de saída do construtor de imagens de um modelo de construtor de imagens.

 Núcleo GA
az image builder output remove

Remova um distribuidor de saída do construtor de imagens de um modelo de construtor de imagens.

 Núcleo GA
az image builder output versioning

Gerenciar o controle de versão de saída do modelo do construtor de imagens.

 Núcleo GA
az image builder output versioning remove

Remova todas as opções de controle de versão em saídas especificadas.

 Núcleo GA
az image builder output versioning set

Defina o controle de versão de saída do construtor de imagens de um modelo de construtor de imagens.

 Núcleo GA
az image builder output versioning show

Mostrar opções de controle de versão em saídas especificadas.

 Núcleo GA
az image builder run

Crie um modelo de construtor de imagens.

 Núcleo GA
az image builder show

Mostrar um modelo do construtor de imagens.

 Núcleo GA
az image builder show-runs

Mostrar as saídas de execução de um modelo do construtor de imagens.

 Núcleo GA
az image builder trigger

Gerenciar o gatilho de modelo do construtor de imagens.

 Núcleo GA
az image builder trigger create

Crie um gatilho para o modelo de imagem de máquina virtual especificado.

 Núcleo GA
az image builder trigger delete

Exclua um gatilho para o modelo de imagem de máquina virtual especificado.

 Núcleo GA
az image builder trigger list

Liste todos os gatilhos para o recurso de Modelo de Imagem especificado.

 Núcleo GA
az image builder trigger show

Obtenha o gatilho especificado para o recurso de modelo de imagem especificado.

 Núcleo GA
az image builder trigger wait

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

 Núcleo GA
az image builder update

Atualize um modelo do construtor de imagens.

 Núcleo GA
az image builder validator

Gerenciar validação de modelo do construtor de imagens.

 Núcleo GA
az image builder validator add

Adicione validar a um modelo de construtor de imagens existente.

 Núcleo GA
az image builder validator remove

Remova a validação de um modelo de construtor de imagens existente.

 Núcleo GA
az image builder validator show

Mostrar a validação de um modelo de construtor de imagens existente.

 Núcleo GA
az image builder wait

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

 Núcleo GA

az image builder cancel

Cancele o build de imagem de execução longa com base no modelo de imagem.

az image builder cancel [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]

Exemplos

Cancelar um build de imagem.

az image builder cancel -n mytemplate -g my-group

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--name -n

O nome do modelo de imagem.

--resource-group -g

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

--subscription

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

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 image builder create

Crie um modelo de construtor de imagens.

az image builder create --name
                        --resource-group
                        [--build-timeout]
                        [--build-vm-identities]
                        [--checksum]
                        [--defer]
                        [--identity]
                        [--image-source]
                        [--image-template]
                        [--location]
                        [--managed-image-destinations]
                        [--no-wait]
                        [--os-disk-size]
                        [--proxy-vm-size]
                        [--scripts]
                        [--shared-image-destinations]
                        [--staging-resource-group]
                        [--subnet]
                        [--tags]
                        [--validator]
                        [--vm-size]
                        [--vnet]

Exemplos

Crie um modelo de construtor de imagens a partir de uma imagem do Ubuntu2204. Distribua-a como uma imagem gerenciada e uma versão de imagem da galeria de imagens compartilhadas. Especifique a ID do grupo de recursos de preparo como o modelo de imagem que será usado para criar a imagem.

scripts="https://my-script-url.net/customize_script.sh"
imagesource="Canonical:0001-com-ubuntu-server-jammy:22_04-lts-gen2:latest"

az image builder create --image-source $imagesource -n myTemplate -g myGroup \
    --scripts $scripts --managed-image-destinations image_1=westus \
    --shared-image-destinations my_shared_gallery/linux_image_def=westus,brazilsouth \
    --identity myIdentity --staging-resource-group myStagingResourceGroup

Crie um modelo de construtor de imagens usando um arquivo de modelo de imagem.

az image builder create -g my-group -n myTemplate --image-template filename

[Avançado] Crie um modelo de imagem com vários personalizadores e distribuidores usando o cache de objetos da CLI por meio de --defer. Dá suporte a recursos como: nomes de personalização e saída, códigos de saída do PowerShell, scripts embutidos, reinicialização do Windows, personalizadores de arquivos, marcas de artefato e distribuidores de saída VHD.

script="https://my-script-url.com/customize_script.ps1"
imagesource="MicrosoftWindowsServer:WindowsServer:2019-Datacenter:2019.0.20190214"

# create and update template object in local cli cache. Defers put request to ARM
# Cache object ttl set via az configure.
az image builder create --image-source $imagesource -n myTemplate \
    -g myGroup --scripts $script --identity myIdentity --defer

# add customizers
az image builder customizer add -n myTemplate -g myGroup  \
    --customizer-name myPwshScript --exit-codes 0 1 --inline-script \
    "mkdir c:\buildActions" "echo Azure-Image-Builder-Was-Here \
     > c:\buildActions\Output.txt" --type powershell --defer

az image builder customizer add -n myTemplate -g myGroup \
    --customizer-name myFileCustomizer --type file \
    --file-source "https://my-file-source.net/file.txt"  \
    --dest-path "c:\buildArtifacts\file.txt" --defer

# add distributors
az image builder output add -n myTemplate -g myGroup --is-vhd \
    --output-name myWinImageVhd --artifact-tags "is_vhd=True" --defer

az image builder output add -n myTemplate -g myGroup \
    --output-name myWinImageManaged --managed-image winImage \
    --managed-image-location eastus \
    --artifact-tags "is_vhd=False" --defer

# Stop deferring put request to ARM. Create the template from the object cache.
# Cache object will be deleted.
az image builder update -n myTemplate -g myGroup

Parâmetros Exigidos

--name -n

O nome do modelo de imagem.

--resource-group -g

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

Parâmetros Opcionais

--build-timeout

A duração máxima a ser aguardada durante a criação do modelo de imagem, em minutos. O padrão é 60.

--build-vm-identities

Configuração opcional da rede virtual a ser usada para implantar a máquina virtual de build. Omita se nenhuma rede virtual específica precisar ser usada.

--checksum

A soma de verificação SHA256 da imagem ISO do Red Hat.

--defer

Armazene temporariamente o objeto no cache local em vez de enviar para o Azure. Use comandos az cache para exibir/limpar.

--identity

Lista de identidades atribuídas pelo usuário (nome ou ID, espaço delimitado) do modelo de imagem.

--image-source -i

A imagem base a ser personalizada. Deve ser uma URN de imagem de plataforma válida, alias de imagem de plataforma, URI de imagem ISO do Red Hat, ID/nome da imagem gerenciada ou ID da versão da imagem compartilhada.

Valor de: az vm image list, az vm image show
--image-template

Caminho local ou URL para um arquivo de modelo de imagem. Ao usar --image-template, todos os outros parâmetros são ignorados, exceto -g e -n. Referência: https://learn.microsoft.com/azure/virtual-machines/linux/image-builder-json.

--location -l

Localização. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--managed-image-destinations

Informações do distribuidor de saída de imagem gerenciada. Lista separada por espaço de pares chave-valor. Por exemplo, "image_1=westus2 image_2=westus". Cada chave é o nome ou a ID do recurso da imagem gerenciada a ser criada. Cada valor é o local da imagem.

--no-wait

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

Valor padrão: False
--os-disk-size

Tamanho do disco do sistema operacional em GB. Omita ou especifique 0 para usar o tamanho padrão do disco do sistema operacional do Azure.

--proxy-vm-size

Tamanho da máquina virtual usada para criar, personalizar e capturar imagens (Standard_D1_v2 para imagens gen1 e Standard_D2ds_v4 para imagens gen2).

--scripts

Lista separada por espaço de scripts de shell ou powershell para personalizar a imagem. Cada script deve ser uma URL acessível publicamente. Infere o tipo de script da extensão de arquivo ('.sh' ou'.ps1') ou do tipo de origem. Mais opções de personalizador e flexibilidade, consulte: 'az image template customizer add'.

--shared-image-destinations

Informações do distribuidor de saída da galeria de imagens compartilhadas (sig). Lista separada por espaço de pares chave-valor. Por exemplo, "my_gallery_1/image_def_1=eastus,westus my_gallery_2/image_def_2=uksouth,canadaeast,francesouth". Cada chave é a ID de definição de imagem sig ou o nome da galeria de sig e a definição de imagem de sig delimitada por um "/". Cada valor é uma lista delimitada por vírgulas de locais de réplica.

--staging-resource-group

A ID do grupo de recursos de preparo na mesma assinatura que o modelo de imagem que será usado para criar a imagem.

--subnet

Nome ou ID da sub-rede para implantar a máquina virtual de build.

--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.

--validator

O tipo de validação que você deseja usar na Imagem. Por exemplo, "Shell" pode ser validação de shell.

--vm-size

Tamanho da máquina virtual usada para criar, personalizar e capturar imagens. Omita ou especifique a cadeia de caracteres vazia para usar o padrão (Standard_D1_v2).

--vnet

Nome da VNET para implantar a máquina virtual de build. Você só deve especificá-la quando a sub-rede for um nome.

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 image builder delete

Exclua o modelo do construtor de imagens.

az image builder delete [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]

Exemplos

Exclua o modelo do construtor de imagens. (gerado automaticamente)

az image builder delete --name MyImageTemplate --resource-group MyResourceGroup

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--name -n

O nome do modelo de imagem.

--resource-group -g

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

--subscription

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

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 image builder list

Listar modelos do construtor de imagens.

az image builder list [--resource-group]

Parâmetros Opcionais

--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 image builder run

Crie um modelo de construtor de imagens.

az image builder run [--ids]
                     [--name]
                     [--no-wait]
                     [--resource-group]
                     [--subscription]

Exemplos

Inicie uma execução de build de modelo e aguarde até que ela seja concluída.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='Running'"

az image builder show -n mytemplate -g my-group

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--name -n

O nome do modelo de imagem.

--no-wait

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

Valor padrão: False
--resource-group -g

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

--subscription

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

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 image builder show

Mostrar um modelo do construtor de imagens.

az image builder show [--ids]
                      [--name]
                      [--resource-group]
                      [--subscription]

Exemplos

Mostrar um modelo do construtor de imagens (gerado automaticamente)

az image builder show --name mytemplate  --resource-group my-group

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--name -n

O nome do modelo de imagem.

--resource-group -g

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

--subscription

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

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 image builder show-runs

Mostrar as saídas de execução de um modelo do construtor de imagens.

az image builder show-runs [--ids]
                           [--name]
                           [--output-name]
                           [--resource-group]
                           [--subscription]

Exemplos

Execute uma execução de build de modelo e exiba suas saídas de execução.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='Running'"

az image builder show-runs -n mytemplate -g my-group

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--name -n

O nome do modelo de imagem.

--output-name

Nome da saída de execução do construtor de imagens.

--resource-group -g

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

--subscription

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

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 image builder update

Atualize um modelo do construtor de imagens.

Atualmente, a atualização de modelos de construtor de imagens não tem suporte. Esse comando pode ser usado em conjunto com --defer para atualizar um objeto de modelo de imagem dentro do cache da CLI. Sem --adiar, ele recupera o modelo de imagem especificado do cache e envia uma solicitação ao Azure para criar o modelo de imagem.

az image builder update [--add]
                        [--defer]
                        [--force-string]
                        [--ids]
                        [--name]
                        [--remove]
                        [--resource-group]
                        [--set]
                        [--subscription]

Exemplos

Crie um recurso de modelo de um objeto de modelo no cache da CLI. Consulte "az image builder create/output add/customer add --help" e "az cache -h" para obter mais informações

# create and write template object to local cli cache
az image builder create --image-source {image_source} -n mytemplate -g my-group \
    --scripts {script} --managed-image-destinations image_1=westus --identity myidentity --defer

# add customizers and outputs to local cache template object via az image template output / customizer add
# one can also update cache object properties through generic update options, such as: --set
az image builder output add -n mytemplate -g my-group --output-name my-win-image-managed \
    --artifact-tags "is_vhd=False"  --managed-image winImage --managed-image-location eastus --defer

# send template create request to azure to create template resource
az image builder update -n mytemplate -g my-group

Parâmetros Opcionais

--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valor de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

Valor padrão: []
--defer

Armazene temporariamente o objeto no cache local em vez de enviar para o Azure. Use comandos az cache para exibir/limpar.

--force-string

Ao usar 'set' ou 'add', preserve literais de cadeia de caracteres em vez de tentar converter em JSON.

Valor padrão: False
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--name -n

O nome do modelo de imagem.

--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Valor padrão: []
--resource-group -g

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

--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=<value>.

Valor padrão: []
--subscription

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

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 image builder wait

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

az image builder wait [--created]
                      [--custom]
                      [--deleted]
                      [--exists]
                      [--ids]
                      [--interval]
                      [--name]
                      [--resource-group]
                      [--subscription]
                      [--timeout]
                      [--updated]

Exemplos

Inicie uma execução de build de modelo e aguarde até que ela seja concluída.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='Running'"

az image builder show -n mytemplate -g my-group

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

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--interval

Intervalo de sondagem em segundos.

Valor padrão: 30
--name -n

O nome do modelo de imagem.

--resource-group -g

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

--subscription

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

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