az sig image-version
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 a versão da imagem da galeria compartilhada com a VM.
Comandos
| Nome | Description | Tipo | Status |
|---|---|---|---|
| az sig image-version create |
Cria uma versão de imagem. |
Núcleo | GA |
| az sig image-version delete |
Exclua uma versão da imagem da galeria. |
Núcleo | GA |
| az sig image-version list |
Listar versões de imagem da galeria em uma definição de imagem da galeria. |
Núcleo | GA |
| az sig image-version list-community |
Listar versões de imagem de VM em uma comunidade de galeria. |
Núcleo | GA |
| az sig image-version list-community (image-gallery extensão) |
Listar versões de imagem de VM em uma comunidade de galeria (visualização). |
Extensão | Habilitação |
| az sig image-version list-shared |
Listar versões de imagem de VM em uma galeria compartilhada diretamente com sua assinatura ou locatário. |
Núcleo | GA |
| az sig image-version show |
Recupera informações sobre uma versão de imagem da galeria. |
Núcleo | GA |
| az sig image-version show-community |
Obtenha uma versão de imagem da galeria da comunidade. |
Núcleo | GA |
| az sig image-version show-community (image-gallery extensão) |
Obter uma versão da imagem em uma comunidade da galeria (visualização). |
Extensão | Habilitação |
| az sig image-version show-shared |
Obtenha uma versão de imagem em uma galeria compartilhada diretamente com sua assinatura ou locatário. |
Núcleo | GA |
| az sig image-version undelete |
Restaure a versão da imagem excluída suave. |
Núcleo | Visualizar |
| az sig image-version update |
Atualizar uma versão de imagem de compartilhamento. |
Núcleo | GA |
| az sig image-version wait |
Aguarde a operação relacionada à versão da imagem. |
Núcleo | GA |
az sig image-version create
Cria uma versão de imagem.
Essa operação pode levar muito tempo, dependendo do número da região de replicação. O uso de "--no-wait" é aconselhado.
az sig image-version create --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--allow-replicated-location-deletion {false, true}]
[--data-snapshot-luns]
[--data-snapshots]
[--data-vhds-luns]
[--data-vhds-sa]
[--data-vhds-uris]
[--end-of-life-date]
[--exclude-from-latest {false, true}]
[--image-version]
[--location]
[--managed-image]
[--no-wait]
[--os-snapshot]
[--os-vhd-storage-account]
[--os-vhd-uri]
[--replica-count]
[--replication-mode {Full, Shallow}]
[--storage-account-type {Premium_LRS, Standard_LRS, Standard_ZRS}]
[--tags]
[--target-edge-zone-encryption]
[--target-edge-zones]
[--target-region-cvm-encryption]
[--target-region-encryption]
[--target-regions]
[--virtual-machine]Exemplos
Adicionar uma nova versão de imagem de uma máquina virtual
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVMAdicionar uma nova versão de imagem a partir de uma imagem gerenciada
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--managed-image /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/images/MyManagedImageAdicionar uma nova versão de imagem a partir de outra versão de imagem
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--image-version /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/galleries/MyGallery/images/MyImageDefinition/versions/1.0.0Adicionar uma nova versão de imagem a partir de um disco gerenciado
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyOSDiskAdicionar uma nova versão de imagem de um disco gerenciado e adicionar discos de dados adicionais
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyOSDisk \
--data-snapshots /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyDataDisk \
--data-snapshot-luns 0Adicione uma nova versão de imagem a partir de um instantâneo de um disco do sistema operacional.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyOsDiskSnapshotAdicionar uma nova versão de imagem a partir de um instantâneo de um disco do sistema operacional e adicionar instantâneos adicionais como discos de dados
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-snapshot /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyOsDiskSnapshot \
--data-snapshots /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyDiskSnapshot \
--data-snapshot-luns 0Adicione uma nova versão de imagem de um VHD de um disco do sistema operacional.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-vhd-storage-account /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/mystorageaccount \
--os-vhd-uri https://mystorageaccount.blob.core.windows.net/container/path_to_vhd_fileAdicionar uma nova versão de imagem de um VHD de um disco do sistema operacional e adicionar VHDs adicionais como discos de dados
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-vhd-storage-account /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/mystorageaccount \
--os-vhd-uri https://mystorageaccount.blob.core.windows.net/container/path_to_vhd_file \
--data-vhds-sa /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/myotherstorageaccount \
--data-vhds-uris https://myotherstorageaccount.blob.core.windows.net/container/path_to_vhd_file \
--data-vhds-luns 0Você pode combinar snapshots, discos gerenciados e VHDs para criar uma nova versão de imagem. Adicione uma nova versão de imagem usando um VHD como disco do sistema operacional e um disco gerenciado e um instantâneo como discos de dados.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--os-vhd-storage-account /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Storage/storageAccounts/mystorageaccount \
--os-vhd-uri https://mystorageaccount.blob.core.windows.net/container/path_to_vhd_file \
--data-snapshots /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/disks/MyDataDisk subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/snapshots/MyDiskSnapshot \
--data-snapshot-luns 0 1Adicione uma nova versão da imagem e copie-a para regiões adicionais. O local de origem da versão da imagem deve ser incluído na lista de regiões de destino. Para cada região adicional, você pode especificar uma contagem de réplicas e um tipo de conta de armazenamento diferentes. Caso contrário, a região herdará do global. A contagem de réplicas padrão é 1 e o tipo de conta de armazenamento padrão é LRS padrão. Neste exemplo, eastus2 terá uma réplica armazenada no armazenamento Standard ZRS, ukwest terá 3 réplicas armazenadas no armazenamento Standard ZRS, southindia terá uma réplica armazenada no armazenamento Standard LRS e brazilsouth terá 2 réplicas armazenadas no armazenamento Standard LRS.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 --replica-count 1 \
--storage-account-type Standard_ZRS --managed-image image-name \
--target-regions eastus2 ukwest=3 southindia=standard_lrs \
brazilsouth=2=standard_lrsAdicione uma nova versão de imagem com criptografia usando um conjunto de criptografia de disco. A criptografia é aplicada a cada disco que faz parte da versão da imagem.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--target-regions westus=2=standard eastus \
--target-region-encryption WestUSDiskEncryptionSet1,0,WestUSDiskEncryptionSet2 \
EastUSDiskEncryptionSet1,0,EastUSDiskEncryptionSet2Adicione uma nova versão da imagem e copie-a para locais estendidos.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 --replica-count 1 \
--storage-account-type Standard_ZRS --managed-image image-name \
--target-edge-zones westus=microsoftlosangeles1 eastus=microsoftlosangeles2=1 \
brazilsouth=2=standard_lrsAdicione uma nova versão de imagem e copie-a para locais estendidos com criptografia usando um conjunto de criptografia de disco.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--target-edge-zones westus=microsoftlosangeles1 \
--target-edge-zone-encryption microsoftlosangeles1,WestUSDiskEncryptionSet1,0,WestUSDiskEncryptionSet2Adicione uma nova versão da imagem e não espere por ela. Mais tarde, você pode invocar o comando "az sig image-version wait" quando estiver pronto para criar uma vm a partir da versão da imagem da galeria
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--no-waitAdicionar uma nova versão de imagem, mas removê-la da consideração como versão mais recente em sua definição de imagem
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--exclude-from-latest trueAdicione uma nova versão da imagem e defina sua data de fim de vida. A versão da imagem ainda pode ser usada para criar uma máquina virtual após sua data de fim de vida.
az sig image-version create --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--virtual-machine /subscriptions/00000000-0000-0000-0000-00000000xxxx/resourceGroups/imageGroups/providers/Microsoft.Compute/virtualMachines/MyVM \
--end-of-life-date 2024-08-02T00:00:00+00:00Parâmetros Exigidos
Definição de imagem da galeria.
Versão da imagem da galeria no padrão de versão semântica. Os caracteres permitidos são dígito e ponto. Os dígitos devem estar dentro do intervalo de um inteiro de 32 bits, por exemplo <MajorVersion>.<MinorVersion>.<Patch>, .
Nome da galeria.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Indique se é permitido ou não remover esta versão da imagem da galeria das regiões replicadas.
Números de unidade lógica (delimitados por espaço) de instantâneos de disco de dados.
Nomes ou IDs (delimitados por espaço) de instantâneos de disco de dados.
Números de unidade lógica (delimitados por espaço) de URIs VHD de origem de discos de dados.
Nomes ou IDs (delimitados por espaço) de contas de armazenamento de URIs VHD de origem de discos de dados.
URIs VHD de origem (delimitados por espaço) de discos de dados.
A data de fim de vida, por exemplo, '2020-12-31'.
O sinalizador significa que, se estiver definido como true, as pessoas que implantarem VMs com a versão omitida não usarão essa versão.
ID do recurso da origem da versão da imagem da galeria.
Local. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.
Nome da imagem(se estiver no mesmo grupo de recursos) ou ID do recurso.
Não aguarde a conclusão da operação de execução longa.
Nome ou ID do instantâneo do disco do sistema operacional.
Nome ou ID da conta de armazenamento do VHD URI de origem do disco do sistema operacional.
URI VHD de origem do disco do sistema operacional.
O número padrão de réplicas a serem criadas por região. Para definir contagens de replicação regional, use --target-regions.
Parâmetro opcional que especifica o modo a ser usado para replicação. Esta propriedade não é atualizável.
O tipo de conta de armazenamento padrão a ser usado por região. Para definir tipos de conta de armazenamento regional, use --target-regions.
Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as tags existentes.
Lista separada por espaço de chaves gerenciadas pelo cliente para criptografar o sistema operacional e os discos de dados no artefato da galeria para cada região. Formato para cada zona de borda: ,os_des,,<lun1_des>,,<lun2_des<>.>
Lista separada por espaço de regiões, zonas de borda, contagens de réplicas e tipos de armazenamento. Use =[=][=] para definir opcionalmente a contagem de réplicas e/ou o tipo de conta de armazenamento para cada região. Se uma contagem de réplicas não for especificada, a contagem de réplicas padrão será usada. Se um tipo de conta de armazenamento não for especificado, o tipo de conta de armazenamento padrão será usado. Se "--target-edge-zones None" for especificado, os locais estendidos de destino serão limpos.
Lista separada por espaço da chave gerenciada pelo cliente para VM confidencial criptografando o disco do sistema operacional no artefato da galeria para cada região. Formato para cada região: <os_cvm_encryption_type>,<os_cvm_des>. Os valores válidos para os_cvm_encryption_type são EncryptedVMGuestStateOnlyWithPmk, EncryptedWithPmk, EncryptedWithCmk.
Lista separada por espaço de chaves gerenciadas pelo cliente para criptografar o sistema operacional e os discos de dados no artefato da galeria para cada região. Formato para cada região: <os_des>,<lun1>,<lun1_des>,<lun2>,<lun2_des>. Use "null" como um espaço reservado.
Lista separada por espaço de regiões e suas contagens de réplicas. Use <region>[=<replica count>][=<storage account type>] para definir opcionalmente a contagem de réplicas e/ou o tipo de conta de armazenamento para cada região. Se uma contagem de réplicas não for especificada, a contagem de réplicas padrão será usada. Se um tipo de conta de armazenamento não for especificado, o tipo de conta de armazenamento padrão será usado.
ID do recurso da origem da VM.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az sig image-version delete
Exclua uma versão da imagem da galeria.
az sig image-version delete [--gallery-image-definition]
[--gallery-image-version]
[--gallery-name]
[--ids]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]Parâmetros Opcionais
O nome da definição de imagem da galeria na qual a Versão da Imagem reside.
O nome da versão da imagem da galeria a ser excluída.
O nome da Galeria de Imagens Compartilhadas na qual a Definição de Imagem reside.
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'.
Não aguarde a conclusão da operação de execução longa.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az sig image-version list
Listar versões de imagem da galeria em uma definição de imagem da galeria.
az sig image-version list --gallery-image-definition
--gallery-name
--resource-group
[--max-items]
[--next-token]Parâmetros Exigidos
Definição de imagem da galeria.
Nome da galeria.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
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.
Token para especificar onde iniciar a paginação. Esse é o valor de token de uma resposta truncada anteriormente.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az sig image-version list-community
Listar versões de imagem de VM em uma comunidade de galeria.
az sig image-version list-community [--gallery-image-definition]
[--ids]
[--location]
[--marker]
[--public-gallery-name]
[--show-next-marker]
[--subscription]Exemplos
Listar versões de uma imagem em uma comunidade de galeria.
az sig image-version list-community --public-gallery-name publicGalleryName \
--gallery-image-definition MyImage --location myLocationParâmetros Opcionais
O nome da definição de imagem da galeria da comunidade a partir da qual as versões da imagem devem ser listadas.
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'.
Local. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.
Um valor de cadeia de caracteres que identifica a parte da lista de contêineres a serem retornados com a próxima operação de listagem. A operação retorna o valor NextMarker dentro do corpo da resposta se a operação de listagem não retornar todos os contêineres restantes a serem listados com a página atual. Se especificado, este gerador começará a retornar resultados do ponto onde o gerador anterior parou.
O nome público da galeria da comunidade.
Mostrar nextMarker no resultado quando especificado.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az sig image-version list-community (image-gallery extensão)
Esse comando é experimental e está em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Listar versões de imagem de VM em uma comunidade de galeria (visualização).
Listar versões de imagens VM em uma comunidade de galeria (recurso de visualização privada, entre em contato com a equipe da galeria de imagens da comunidade por e-mail sigpmdev@microsoft.com para se registrar para visualização se estiver interessado em usar esse recurso).
az sig image-version list-community [--gallery-image-definition]
[--ids]
[--location]
[--marker]
[--public-gallery-name]
[--show-next-marker]
[--subscription]Exemplos
Listar versões de uma imagem em uma comunidade de galeria.
az sig image-version list-community --public-gallery-name publicGalleryName \
--gallery-image-definition MyImage --location myLocationParâmetros Opcionais
O nome da definição de imagem da galeria da comunidade a partir da qual as versões da imagem devem ser listadas.
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'.
Local. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.
Um valor de cadeia de caracteres que identifica a parte da lista de contêineres a serem retornados com a próxima operação de listagem. A operação retorna o valor NextMarker dentro do corpo da resposta se a operação de listagem não retornar todos os contêineres restantes a serem listados com a página atual. Se especificado, este gerador começará a retornar resultados do ponto onde o gerador anterior parou.
O nome público da galeria da comunidade.
Mostrar nextMarker no resultado quando especificado.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az sig image-version list-shared
Listar versões de imagem de VM em uma galeria compartilhada diretamente com sua assinatura ou locatário.
az sig image-version list-shared [--gallery-image-definition]
[--gallery-unique-name]
[--ids]
[--location]
[--marker]
[--shared-to {tenant}]
[--show-next-marker]
[--subscription]Exemplos
Listar versões de imagem em uma galeria compartilhada diretamente com sua assinatura no local e na definição de imagem fornecidos.
az sig image-version list-shared --gallery-unique-name galleryUniqueName \
--gallery-image-definition MyImage --location myLocationListar versões de imagem em uma galeria compartilhada diretamente com seu locatário no local e na definição de imagem fornecidos.
az sig image-version list-shared --gallery-unique-name galleryUniqueName \
--gallery-image-definition MyImage --location myLocation --shared-to tenantParâmetros Opcionais
O nome da Definição de Imagem da Galeria Compartilhada a partir da qual as Versões de Imagem devem ser listadas.
O nome exclusivo da Galeria Compartilhada.
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'.
Local. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.
Um valor de cadeia de caracteres que identifica a parte da lista de contêineres a serem retornados com a próxima operação de listagem. A operação retorna o valor NextMarker dentro do corpo da resposta se a operação de listagem não retornar todos os contêineres restantes a serem listados com a página atual. Se especificado, este gerador começará a retornar resultados do ponto onde o gerador anterior parou.
O parâmetro de consulta para decidir quais galerias compartilhadas buscar ao fazer operações de listagem. Se não for especificado, liste por ID de assinatura.
Mostrar nextMarker no resultado quando especificado.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az sig image-version show
Recupera informações sobre uma versão de imagem da galeria.
az sig image-version show --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--expand]Parâmetros Exigidos
Definição de imagem da galeria.
Versão da imagem da galeria no padrão de versão semântica. Os caracteres permitidos são dígito e ponto. Os dígitos devem estar dentro do intervalo de um inteiro de 32 bits, por exemplo <MajorVersion>.<MinorVersion>.<Patch>, .
Nome da galeria.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
A expressão de expansão a ser aplicada na operação, por exemplo, 'ReplicationStatus'.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az sig image-version show-community
Obtenha uma versão de imagem da galeria da comunidade.
az sig image-version show-community [--gallery-image-definition]
[--gallery-image-version]
[--ids]
[--location]
[--public-gallery-name]
[--subscription]Parâmetros Opcionais
O nome da definição de imagem da galeria da comunidade a partir da qual as versões da imagem devem ser listadas.
Versão da imagem da galeria no padrão de versão semântica. Os caracteres permitidos são dígito e ponto. Os dígitos devem estar dentro do intervalo de um inteiro de 32 bits, por exemplo <MajorVersion>.<MinorVersion>.<Patch>, .
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'.
Local. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.
O nome público da galeria comunitária.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az sig image-version show-community (image-gallery extensão)
Esse comando é experimental e está em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Obter uma versão da imagem em uma comunidade da galeria (visualização).
Obtenha uma versão da imagem em uma comunidade da galeria (recurso de visualização privada, entre em contato com a equipe da galeria de imagens da comunidade por e-mail sigpmdev@microsoft.com para se registrar para visualização se estiver interessado em usar esse recurso).
az sig image-version show-community [--gallery-image-definition]
[--gallery-image-version]
[--ids]
[--location]
[--public-gallery-name]
[--subscription]Exemplos
Obtenha uma versão da imagem em uma comunidade de galeria no local especificado.
az sig image-version show-community --public-gallery-name publicGalleryName \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 --location myLocationParâmetros Opcionais
O nome da definição de imagem da galeria da comunidade a partir da qual as versões da imagem devem ser listadas.
O nome da versão da imagem da galeria a ser criada. Precisa seguir o padrão semântico de nome de versão: Os caracteres permitidos são dígito e ponto. Os dígitos devem estar dentro do intervalo de um inteiro de 32 bits. Formato:...
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'.
Local. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.
O nome público da galeria da comunidade.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az sig image-version show-shared
Obtenha uma versão de imagem em uma galeria compartilhada diretamente com sua assinatura ou locatário.
az sig image-version show-shared [--gallery-image-definition]
[--gallery-image-version]
[--gallery-unique-name]
[--ids]
[--location]
[--subscription]Exemplos
Obtenha uma versão de imagem em uma galeria compartilhada diretamente com sua assinatura ou locatário no local especificado.
az sig image-version show-shared --gallery-unique-name galleryUniqueName --gallery-image-definition MyImage --gallery-image-version 1.0.0 --location myLocationParâmetros Opcionais
O nome da Definição de Imagem da Galeria Compartilhada a partir da qual as Versões de Imagem devem ser listadas.
O nome da versão da imagem da galeria a ser criada. Precisa seguir o padrão semântico de nome de versão: Os caracteres permitidos são dígito e ponto. Os dígitos devem estar dentro do intervalo de um inteiro de 32 bits. Formato:...
O nome exclusivo da Galeria Compartilhada.
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'.
Local. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az sig image-version undelete
Este comando está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Restaure a versão da imagem excluída suave.
A operação só será bem-sucedida se for usada dentro de uma Galeria com exclusão suave ativada.
az sig image-version undelete --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--allow-replicated-location-deletion {false, true}]
[--location]
[--no-wait]
[--tags]Exemplos
Restaurar uma versão de imagem excluída suave
az sig image-version undelete --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.1.1Parâmetros Exigidos
Definição de imagem da galeria.
Versão da imagem da galeria no padrão de versão semântica. Os caracteres permitidos são dígito e ponto. Os dígitos devem estar dentro do intervalo de um inteiro de 32 bits, por exemplo <MajorVersion>.<MinorVersion>.<Patch>, .
Nome da galeria.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Indique se é permitido ou não remover esta versão da imagem da galeria das regiões replicadas.
Local. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.
Não aguarde a conclusão da operação de execução longa.
Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as tags existentes.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az sig image-version update
Atualizar uma versão de imagem de compartilhamento.
az sig image-version update --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--add]
[--allow-replicated-location-deletion {false, true}]
[--force-string]
[--no-wait]
[--remove]
[--replica-count]
[--set]
[--target-edge-zones]
[--target-regions]Exemplos
Alterar as regiões de replicação e a contagem de réplicas
az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--target-regions westcentralus=2 eastus2Alterar os locais estendidos de replicação
az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--target-edge-zones westus=microsoftlosangeles1 eastus=microsoftlosangeles2=1Limpar os locais estendidos de replicação
az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--target-edge-zones NoneReplicar para uma região adicional. Opcional, você pode definir a contagem de réplicas para a região e excluir essa imagem ao usar a versão mais recente da definição de imagem.
az sig image-version update --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0 \
--add publishingProfile.targetRegions name=westcentralus \
regionalReplicaCount=3 excludeFromLatest=trueAltere se uma imagem deve ser incluída em consideração para a versão mais recente na definição da imagem. Definir esse valor como true exclui a imagem da consideração e definir esse valor como false inclui a imagem para consideração.
az sig image-version update -g MyResourceGroup --gallery-name MyGallery \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 \
--set publishingProfile.excludeFromLatest=trueAlterar a data de fim de vida útil de uma versão de imagem. A imagem ainda pode ser usada para criar máquinas virtuais após a data de fim de vida útil.
az sig image-version update -g MyResourceGroup --gallery-name MyGallery \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 \
--set publishingProfile.endOfLifeDate=2024-08-02T00:00:00+00:00Permitir remover a versão da imagem da galeria das regiões replicadas.
az sig image-version update -g MyResourceGroup --gallery-name MyGallery \
--gallery-image-definition MyImage --gallery-image-version 1.0.0 \
--set safetyProfile.allowDeletionOfReplicatedLocations=trueParâmetros Exigidos
Definição de imagem da galeria.
Versão da imagem da galeria no padrão de versão semântica. Os caracteres permitidos são dígito e ponto. Os dígitos devem estar dentro do intervalo de um inteiro de 32 bits, por exemplo <MajorVersion>.<MinorVersion>.<Patch>, .
Nome da galeria.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
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>.
Indique se é permitido ou não remover esta versão da imagem da galeria das regiões replicadas.
Ao usar 'set' ou 'add', preserve literais de cadeia de caracteres em vez de tentar converter para JSON.
Não aguarde a conclusão da operação de execução longa.
Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OU --remove propertyToRemove.
O número padrão de réplicas a serem criadas por região. Para definir contagens de replicação regional, use --target-regions.
Atualize um objeto especificando um caminho de propriedade e um valor a serem definidos. Exemplo: --set property1.property2=<value>.
Lista separada por espaço de regiões, zonas de borda, contagens de réplicas e tipos de armazenamento. Use =[=][=] para definir opcionalmente a contagem de réplicas e/ou o tipo de conta de armazenamento para cada região. Se uma contagem de réplicas não for especificada, a contagem de réplicas padrão será usada. Se um tipo de conta de armazenamento não for especificado, o tipo de conta de armazenamento padrão será usado. Se "--target-edge-zones None" for especificado, os locais estendidos de destino serão limpos.
Lista separada por espaço de regiões e suas contagens de réplicas. Use <region>[=<replica count>][=<storage account type>] para definir opcionalmente a contagem de réplicas e/ou o tipo de conta de armazenamento para cada região. Se uma contagem de réplicas não for especificada, a contagem de réplicas padrão será usada. Se um tipo de conta de armazenamento não for especificado, o tipo de conta de armazenamento padrão será usado.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az sig image-version wait
Aguarde a operação relacionada à versão da imagem.
az sig image-version wait --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--created]
[--custom]
[--deleted]
[--exists]
[--expand]
[--interval]
[--timeout]
[--updated]Exemplos
aguarde até que uma versão da imagem seja atualizada
az sig image-version wait --updated --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0aguarde a operação relacionada à versão da imagem. (gerado automaticamente)
az sig image-version wait --created --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.0.0Parâmetros Exigidos
Definição de imagem da galeria.
Versão da imagem da galeria no padrão de versão semântica. Os caracteres permitidos são dígito e ponto. Os dígitos devem estar dentro do intervalo de um inteiro de 32 bits, por exemplo <MajorVersion>.<MinorVersion>.<Patch>, .
Nome da galeria.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Aguarde até criar com 'provisioningState' em 'Succeeded'.
Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Aguarde até ser excluído.
Aguarde até que o recurso exista.
A expressão de expansão a ser aplicada na operação. O valor padrão 'ReplicationStatus' é Nenhum.
Intervalo de sondagem em segundos.
Espera máxima em segundos.
Aguarde até que seja atualizado com provisioningState em 'Succeeded'.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
