az sig image-version
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 a versão da imagem da galeria compartilhada com a VM.
Comandos
| Name | Description | Tipo | Estado |
|---|---|---|---|
| az sig image-version create |
Crie uma nova versão da imagem. |
Principal | GA |
| az sig image-version delete |
Exclua uma versão da imagem da galeria. |
Principal | GA |
| az sig image-version list |
Listar versões de imagens de galeria em uma definição de imagem de galeria. |
Principal | GA |
| az sig image-version list-community |
Liste versões de imagem de VM em uma comunidade de galeria. |
Principal | 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 | Experimental |
| az sig image-version list-shared |
Liste Versões de Imagem de VM em uma galeria compartilhada diretamente com sua assinatura ou locatário. |
Principal | GA |
| az sig image-version show |
Recupera informações sobre uma versão de imagem de galeria. |
Principal | GA |
| az sig image-version show-community |
Obtenha uma versão da imagem da galeria da comunidade. |
Principal | GA |
| az sig image-version show-community (image-gallery extensão) |
Obtenha uma versão da imagem numa comunidade de galerias (pré-visualização). |
Extensão | Experimental |
| az sig image-version show-shared |
Obtenha uma versão de imagem numa galeria partilhada diretamente com a sua subscrição ou inquilino. |
Principal | GA |
| az sig image-version undelete |
Restaure a versão da imagem excluída suavemente. |
Principal | Pré-visualizar |
| az sig image-version update |
Atualize uma versão de imagem de compartilhamento. |
Principal | GA |
| az sig image-version wait |
Aguarde a operação relacionada à versão da imagem. |
Principal | GA |
az sig image-version create
Crie uma nova versão da imagem.
Essa operação pode levar muito tempo, dependendo do número da região replicada. Aconselha-se o uso de "--no-wait".
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 da imagem a partir de outra 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 \
--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 a partir 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 instantâneos, 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 outras regiões. 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éplica 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 ZRS padrão, ukwest terá 3 réplicas armazenadas no armazenamento ZRS padrão, southindia terá uma réplica armazenada no armazenamento LRS padrão e brazilsouth terá 2 réplicas armazenadas no armazenamento LRS padrão.
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-waitAdicione uma nova versão de imagem, mas remova-a de 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 Obrigatórios
Definição de imagem de 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.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Indique se é permitida ou não a remoção desta versão da imagem da galeria das regiões replicadas.
Números de unidades lógicas (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 unidades lógicas (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 do fim da vida útil, por exemplo, «2020-12-31».
O sinalizador significa que, se estiver definido como true, as pessoas que implantam VMs com versão omitida não usarão essa versão.
ID do recurso da fonte da versão da imagem da galeria.
Localização. 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 espere que a operação de longa duração termine.
Nome ou ID do instantâneo de disco do SO.
Nome ou ID da conta de armazenamento do URI VHD 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 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 de Globais
Aumente a verbosidade 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.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .
Aumente a verbosidade do registro. 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.
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'.
Não espere que a operação de longa duração termine.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
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
Aumente a verbosidade 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.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az sig image-version list
Listar versões de imagens de galeria em uma definição de imagem de galeria.
az sig image-version list --gallery-image-definition
--gallery-name
--resource-group
[--max-items]
[--next-token]Parâmetros Obrigatórios
Definição de imagem de galeria.
Nome da galeria.
o 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 por onde começar a paginar. Este é o valor de token de uma resposta truncada anteriormente.
Parâmetros de Globais
Aumente a verbosidade 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.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az sig image-version list-community
Liste 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
Liste uma versão de 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.
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'.
Localização. 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 de 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.
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
Aumente a verbosidade 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.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az sig image-version list-community (image-gallery extensão)
Este comando é experimental e está em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus
Listar versões de imagem de VM em uma comunidade de galeria (visualização).
Listar versões de imagens de 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
Liste uma versão de 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.
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'.
Localização. 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 de 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.
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
Aumente a verbosidade 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.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az sig image-version list-shared
Liste 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
Liste versões de imagens em uma galeria compartilhadas diretamente com sua assinatura no local e definição de imagem fornecidos.
az sig image-version list-shared --gallery-unique-name galleryUniqueName \
--gallery-image-definition MyImage --location myLocationListe versões de imagens em uma galeria compartilhadas 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.
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'.
Localização. 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 de 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.
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
Aumente a verbosidade 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.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az sig image-version show
Recupera informações sobre uma versão de imagem de galeria.
az sig image-version show --gallery-image-definition
--gallery-image-version
--gallery-name
--resource-group
[--expand]Parâmetros Obrigatórios
Definição de imagem de 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.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
A expressão expand a ser aplicada na operação, por exemplo, 'ReplicationStatus'.
Parâmetros de Globais
Aumente a verbosidade 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.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az sig image-version show-community
Obtenha uma versão da 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>
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'.
Localização. 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.
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
Aumente a verbosidade 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.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az sig image-version show-community (image-gallery extensão)
Este comando é experimental e está em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus
Obtenha uma versão da imagem numa comunidade de galerias (pré-visualização).
Obtenha uma versão da imagem 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 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 determinado.
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 do nome da 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: ...
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'.
Localização. 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.
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
Aumente a verbosidade 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.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az sig image-version show-shared
Obtenha uma versão de imagem numa galeria partilhada diretamente com a sua subscrição ou inquilino.
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 determinado.
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 do nome da 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.
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'.
Localização. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.
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
Aumente a verbosidade 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.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .
Aumente a verbosidade do registro. 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 de apoio: https://aka.ms/CLI_refstatus
Restaure a versão da imagem excluída suavemente.
A operação só será bem-sucedida se 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 suavemente
az sig image-version undelete --resource-group MyResourceGroup \
--gallery-name MyGallery --gallery-image-definition MyImage \
--gallery-image-version 1.1.1Parâmetros Obrigatórios
Definição de imagem de 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.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Indique se é permitida ou não a remoção desta versão da imagem da galeria das regiões replicadas.
Localização. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.
Não espere que a operação de longa duração termine.
Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.
Parâmetros de Globais
Aumente a verbosidade 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.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az sig image-version update
Atualize 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=1Limpe 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. Opcionalmente, 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=trueAltere a data de fim da 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 da 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 de 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 Obrigatórios
Definição de imagem de 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.
o 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 valor de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.
Indique se é permitida ou não a remoção desta versão da imagem da galeria das regiões replicadas.
Ao usar 'set' ou 'add', preserve literais de string em vez de tentar converter para JSON.
Não espere que a operação de longa duração termine.
Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OR --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 ser definido. 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 de Globais
Aumente a verbosidade 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.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .
Aumente a verbosidade do registro. 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 Obrigatórios
Definição de imagem de 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.
o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Aguarde até ser criado 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 expand a ser aplicada na operação. O valor padrão 'ReplicationStatus' é Nenhum.
Intervalo de sondagem em segundos.
Espera máxima em segundos.
Aguarde até ser atualizado com provisioningState em 'Succeeded'.
Parâmetros de Globais
Aumente a verbosidade 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.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
