az image

Nota

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

Gerencie imagens de máquinas virtuais personalizadas.

Comandos

Name	Description	Tipo	Status
az image builder	Gerencie e crie modelos de construtor de imagens.	Principal	GA
az image builder cancel	Cancele a compilação de imagem de longa duração com base no modelo de imagem.	Principal	GA
az image builder create	Crie um modelo de construtor de imagens.	Principal	GA
az image builder customizer	Gerencie personalizadores de modelos do construtor de imagens.	Principal	GA
az image builder customizer add	Adicione um personalizador de construtor de imagens a um modelo de construtor de imagens.	Principal	GA
az image builder customizer clear	Remova todos os personalizadores do construtor de imagens de um modelo de construtor de imagens.	Principal	GA
az image builder customizer remove	Remova um personalizador de construtor de imagens de um modelo de construtor de imagens.	Principal	GA
az image builder delete	Excluir modelo de construtor de imagens.	Principal	GA
az image builder error-handler	Gerenciar manipulador de erros de modelo do construtor de imagens.	Principal	GA
az image builder error-handler add	Adicione o manipulador de erros a um modelo de construtor de imagens existente.	Principal	GA
az image builder error-handler remove	Remova o manipulador de erros de um modelo de construtor de imagens existente.	Principal	GA
az image builder error-handler show	Mostrar manipulador de erro de um modelo de construtor de imagens existente.	Principal	GA
az image builder identity	Gerencie identidades de um modelo de construtor de imagens.	Principal	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.	Principal	GA
az image builder identity remove	Remova identidades gerenciadas de um modelo de construtor de imagens existente.	Principal	GA
az image builder identity show	Exibir identidades gerenciadas de um modelo de construtor de imagens.	Principal	GA
az image builder list	Listar modelos de construtor de imagens.	Principal	GA
az image builder optimizer	Gerencie o otimizador de modelos do construtor de imagens.	Principal	GA
az image builder optimizer add	Adicione o otimizador a um modelo de construtor de imagens existente.	Principal	GA
az image builder optimizer remove	Remova o otimizador de um modelo de construtor de imagens existente.	Principal	GA
az image builder optimizer show	Mostrar otimizador de um modelo de construtor de imagens existente.	Principal	GA
az image builder optimizer update	Atualize um otimizador a partir de um modelo de construtor de imagens existente.	Principal	GA
az image builder output	Gerencie distribuidores de saída de modelo do construtor de imagens.	Principal	GA
az image builder output add	Adicione um distribuidor de saída do construtor de imagens a um modelo de construtor de imagens.	Principal	GA
az image builder output clear	Remova todos os distribuidores de saída do construtor de imagens de um modelo de construtor de imagens.	Principal	GA
az image builder output remove	Remova um distribuidor de saída do construtor de imagens de um modelo do construtor de imagens.	Principal	GA
az image builder output versioning	Gerencie o versionador de saída de modelo do construtor de imagens.	Principal	GA
az image builder output versioning remove	Remova todas as opções de controle de versão nas saídas especificadas.	Principal	GA
az image builder output versioning set	Defina o versionador de saída do construtor de imagens de um modelo de construtor de imagens.	Principal	GA
az image builder output versioning show	Mostrar opções de controle de versão em saídas especificadas.	Principal	GA
az image builder run	Crie um modelo de construtor de imagens.	Principal	GA
az image builder show	Mostrar um modelo de construtor de imagens.	Principal	GA
az image builder show-runs	Mostrar as saídas de execução de um modelo de construtor de imagens.	Principal	GA
az image builder trigger	Gerenciar gatilho de modelo do construtor de imagens.	Principal	GA
az image builder trigger create	Crie um gatilho para o modelo de imagem de máquina virtual especificado.	Principal	GA
az image builder trigger delete	Exclua um gatilho para o modelo de imagem de máquina virtual especificado.	Principal	GA
az image builder trigger list	Liste todos os gatilhos para o recurso de Modelo de Imagem especificado.	Principal	GA
az image builder trigger show	Obtenha o gatilho especificado para o recurso de modelo de imagem especificado.	Principal	GA
az image builder trigger wait	Coloque a CLI em um estado de espera até que uma condição seja atendida.	Principal	GA
az image builder update	Atualize um modelo de construtor de imagens.	Principal	GA
az image builder validator	Gerenciar modelo de construtor de imagens validar.	Principal	GA
az image builder validator add	Adicione validar a um modelo de construtor de imagens existente.	Principal	GA
az image builder validator remove	Remova a validação de um modelo de construtor de imagens existente.	Principal	GA
az image builder validator show	Mostrar validação de um modelo de construtor de imagens existente.	Principal	GA
az image builder wait	Coloque a CLI em um estado de espera até que uma condição do modelo seja atendida.	Principal	GA
az image copy	Copie uma imagem gerenciada (ou vm) para outras regiões. 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 ou instantâneos gerenciados.	Principal	GA
az image delete	Excluir uma imagem.	Principal	GA
az image list	Liste a lista de imagens em um grupo de recursos.	Principal	GA
az image show	Obtenha uma imagem.	Principal	GA
az image update	Atualize imagens de VM personalizadas.	Principal	GA
az image wait	Coloque a CLI em um estado de espera até que uma condição seja atendida.	Principal	GA

az image copy

Copie uma imagem gerenciada (ou vm) para outras regiões. 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 Obrigatórios

--source-object-name

O nome da imagem ou 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 (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.

Default value: False

--export-as-snapshot

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

Default value: False

--parallel-degree

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

Default value: -1

--source-type

Imagem ou vm.

Valores aceites: image, vm

Default value: image

--tags

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

--target-name

Nome da imagem final que será criada.

--target-subscription

Nome ou ID da subscrição 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.

Default value: image-copy-rg

--timeout

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

Default value: 3600

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

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

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

--name -n

Novo nome da imagem.

--resource-group -g

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

--source

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

Parâmetros Opcionais

--data-disk-caching

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

Valores aceites: 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 instantâneo.

--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 aceites: V1, V2

Default value: V1

--location -l

Localização. 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 aceites: None, ReadOnly, ReadWrite

--os-type

Valores aceites: 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 aceites: 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 tags existentes.

--zone-resilient

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

Valores aceites: false, true

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

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

--image-name --name -n

O nome da imagem.

--no-wait

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

Valores aceites: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

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

--subscription

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

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

Liste 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 por onde começar a paginar. Este é o valor de token de uma resposta truncada anteriormente.

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

Obtenha uma imagem.

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

Parâmetros Opcionais

--expand

A expressão expand a ser aplicada na operação.

--ids

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

--image-name --name -n

O nome da imagem.

--resource-group -g

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

--subscription

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

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

Atualize imagens de VM personalizadas.

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

Exemplos

Adicione ou atualize 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 valor de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

Default value: []

--force-string

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

Default value: False

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. 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> OR --remove propertyToRemove.

Default value: []

--resource-group -g

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

Default value: []

--subscription

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

--tags

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

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

--expand

A expressão expand a ser aplicada na operação.

--ids

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

--image-name --name -n

O nome da imagem.

--interval

Intervalo de sondagem em segundos.

Default value: 30

--resource-group -g

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

--subscription

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

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