az image

  • Referência

Observação

Esse grupo de comandos tem comandos definidos na CLI do Azure e em pelo menos uma extensão. Instale cada extensão para se beneficiar de seus recursos estendidos. Saiba mais sobre extensões.

Gerenciar imagens de máquina virtual personalizadas.

Comandos

Nome Description Tipo Status
az image builder

Gerencie e crie modelos de construtor de imagens.

 Núcleo GA
az image builder cancel

Cancele a compilação de imagem de longa execução 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 os personalizadores de modelo do Construtor de Imagens.

 Núcleo GA
az image builder customizer add

Adicione um personalizador de construtor de imagens a um modelo de 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 do 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 manipulador de erros de modelo do construtor de imagens.

 Núcleo GA
az image builder error-handler add

Adicione 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 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, apenas uma identidade de usuário é suportada.

 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 otimizador de modelo do construtor de imagens.

 Núcleo GA
az image builder optimizer add

Adicione o 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 otimizador de um modelo de construtor de imagens existente.

 Núcleo GA
az image builder optimizer update

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

 Núcleo GA
az image builder output

Gerenciar os 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 de 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 do construtor de imagens.

 Núcleo GA
az image builder output versioning

Gerenciar o versionador de saída de modelo do construtor de imagens.

 Núcleo GA
az image builder output versioning remove

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

 Núcleo GA
az image builder output versioning set

Defina o versionador 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 de construtor de imagens.

 Núcleo GA
az image builder show-runs

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

 Núcleo GA
az image builder trigger

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

Atualizar um modelo de 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 validação 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 copy

Copie uma imagem gerenciada (ou vm) para outras regiões. Ele requer que o disco de origem esteja disponível.

 Extensão GA
az image create

Crie uma Imagem de Máquina Virtual personalizada a partir de discos gerenciados ou instantâneos.

 Núcleo GA
az image delete

Excluir uma imagem.

 Núcleo GA
az image list

Listar a lista de imagens em um grupo de recursos.

 Núcleo GA
az image show

Obtenha uma imagem.

 Núcleo GA
az image update

Atualize imagens de VM personalizadas.

 Núcleo GA
az image wait

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

 Núcleo GA

az image copy

Copie uma imagem gerenciada (ou vm) para outras regiões. Ele requer que o disco de origem esteja disponível.

az image copy --source-object-name
              --source-resource-group
              --target-location
              --target-resource-group
              [--cleanup]
              [--export-as-snapshot]
              [--parallel-degree]
              [--source-type {image, vm}]
              [--tags]
              [--target-name]
              [--target-subscription]
              [--temporary-resource-group-name]
              [--timeout]

Exemplos

Copie uma imagem para várias regiões e limpe no final.

az image copy --source-resource-group mySources-rg --source-object-name myImage \
    --target-location uksouth northeurope --target-resource-group "images-repo-rg" --cleanup

Use uma vm já generalizada para criar imagens em outras regiões.

az image copy --source-resource-group mySources-rg --source-object-name myVm \
    --source-type vm --target-location uksouth northeurope --target-resource-group "images-repo-rg"

Parâmetros Exigidos

--source-object-name

O nome da imagem ou do recurso vm.

--source-resource-group

Nome do grupo de recursos do recurso de origem.

--target-location

Lista de locais separados por espaço para criar a imagem em (por exemplo, westeurope etc.).

--target-resource-group

Nome do grupo de recursos no qual criar imagens.

Parâmetros Opcionais

--cleanup

Inclua essa opção para excluir recursos temporários após a conclusão.

Valor padrão: False
--export-as-snapshot

Inclua essa opção para exportar as cópias como instantâneos em vez de imagens.

Valor padrão: False
--parallel-degree

Número de operações de cópia paralela.

Valor padrão: -1
--source-type

Imagem ou vm.

Valores aceitos: image, vm
Valor padrão: image
--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as tags existentes.

--target-name

Nome da imagem final que será criada.

--target-subscription

Nome ou ID da assinatura onde a imagem final deve ser criada.

--temporary-resource-group-name

Nome do Grupo de Recursos onde a conta de armazenamento temporário será criada.

Valor padrão: image-copy-rg
--timeout

Tempo em segundos para a conclusão da operação de cópia. Aumente esse tempo se você for copiar imagens grandes (discos) como 512GB ou mais.

Valor padrão: 3600
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 image create

Crie uma Imagem de Máquina Virtual personalizada a partir de discos gerenciados ou instantâneos.

az image create --name
                --resource-group
                --source
                [--data-disk-caching {None, ReadOnly, ReadWrite}]
                [--data-disk-sources]
                [--edge-zone]
                [--hyper-v-generation {V1, V2}]
                [--location]
                [--os-disk-caching {None, ReadOnly, ReadWrite}]
                [--os-type {Linux, Windows}]
                [--storage-sku {PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS}]
                [--tags]
                [--zone-resilient {false, true}]

Exemplos

Crie uma imagem a partir de um disco existente.

az image create -g MyResourceGroup -n image1 --os-type Linux \
    --source /subscriptions/db5eb68e-73e2-4fa8-b18a-0123456789999/resourceGroups/rg1/providers/Microsoft.Compute/snapshots/s1

Crie uma imagem capturando uma máquina virtual generalizada existente no mesmo grupo de recursos.

az image create -g MyResourceGroup -n image1 --source MyVm1

Parâmetros Exigidos

--name -n

Novo nome de imagem.

--resource-group -g

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

--source

Origem do disco do sistema operacional da mesma região, incluindo um ID ou nome da máquina virtual, URI do blob do disco do sistema operacional, ID ou nome do disco do sistema operacional gerenciado ou ID ou nome do instantâneo do sistema operacional.

Parâmetros Opcionais

--data-disk-caching

Tipo de cache de armazenamento para o disco de dados da imagem.

Valores aceitos: None, ReadOnly, ReadWrite
--data-disk-sources

Lista separada por espaço de fontes de disco de dados, incluindo URI de blob não gerenciado, ID ou nome de disco gerenciado ou ID ou nome de snapshot.

--edge-zone

O nome da zona de borda.

--hyper-v-generation

A geração do hipervisor da Máquina Virtual criada a partir da imagem.

Valores aceitos: V1, V2
Valor padrão: V1
--location -l

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

--os-disk-caching

Tipo de cache de armazenamento para o disco do sistema operacional da imagem.

Valores aceitos: None, ReadOnly, ReadWrite
--os-type
Valores aceitos: Linux, Windows
--storage-sku

A SKU da conta de armazenamento com a qual criar a imagem da VM. Não utilizado se a VM de origem for especificada.

Valores aceitos: PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS
--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as tags existentes.

--zone-resilient

Especifica se uma imagem é resiliente à zona ou não. Padrão é false As imagens resilientes de zona só podem ser criadas em regiões que fornecem armazenamento redundante de zona.

Valores aceitos: false, true
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 image delete

Excluir uma imagem.

az image delete [--ids]
                [--image-name]
                [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                [--resource-group]
                [--subscription]

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--image-name --name -n

O nome da imagem.

--no-wait

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

Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--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 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 image list

Listar a lista de imagens em um grupo de recursos.

az image list [--max-items]
              [--next-token]
              [--resource-group]

Parâmetros Opcionais

--max-items

Número total de itens a serem retornados na saída do comando. Se o número total de itens disponíveis for maior do que o valor especificado, um token será fornecido na saída do comando. Para retomar a paginação, forneça o valor do token no --next-token argumento de um comando subsequente.

--next-token

Token para especificar onde iniciar a paginação. Esse é o valor de token de uma resposta truncada anteriormente.

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

Obtenha uma imagem.

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

Parâmetros Opcionais

--expand

A expressão de expansão a ser aplicada na operação.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--image-name --name -n

O nome da 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 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 image update

Atualize imagens de VM personalizadas.

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

Exemplos

Adicionar ou atualizar tags.

az image update -n ImageName -g ResourceGroup --tags tag1=val1 tag2=val2

Remova todas as tags.

az image update -n ImageName -g resourceGroup --tags

Parâmetros Opcionais

--add

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

Valor padrão: []
--force-string

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

Valor padrão: False
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

O nome da imagem. Obrigatório.

--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OU --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 serem definidos. 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.

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as tags existentes.

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

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

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

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

A expressão de expansão a ser aplicada na operação.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--image-name --name -n

O nome da imagem.

--interval

Intervalo de sondagem em segundos.

Valor padrão: 30
--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 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.