az sig image-version
Nota
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 |
Crie uma nova versão da 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 galerias. |
Núcleo | GA |
| az sig image-version list-community (image-gallery extensão) |
Listar versões de imagem de VM em uma comunidade da galeria (versão prévia). |
Extensão | Experimental |
| 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) |
Obtenha uma versão de imagem em uma comunidade de galerias (versão prévia). |
Extensão | Experimental |
| 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 |
Restaurar a versão da imagem excluída suavemente. |
Núcleo | Visualizar |
| az sig image-version update |
Atualize 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
Crie uma nova versão da imagem.
Essa operação pode levar muito tempo dependendo do número da região de replicação. Use "--no-wait" é aconselhável.
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 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 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 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 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 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 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 o 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 de imagem e copie-a para regiões adicionais. A localização inicial da origem da versão da imagem deve ser incluída na lista de regiões de destino. Para cada região adicional, você pode especificar um tipo de conta de armazenamento e contagem de réplicas diferente. 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 Standard. Neste exemplo, eastus2 terá uma réplica armazenada no armazenamento ZRS Standard, o ukwest terá três réplicas armazenadas no armazenamento ZRS Standard, a southindia terá uma réplica armazenada no armazenamento LRS Standard e o brasil terá 2 réplicas armazenadas no armazenamento LRS Standard.
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 de 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 aguarde. Posteriormente, você poderá 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 a 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 útil. A versão da imagem ainda pode ser usada para criar uma máquina virtual após sua data de fim de vida útil.
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 a remoção ou não dessa versão da imagem da galeria de regiões replicadas é permitida.
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 (delimitadas por espaço) de discos de dados.
A data de fim da vida útil, por exemplo, '2020-12-31'.
O sinalizador significa que, se for definido como true, as pessoas que implantarem VMs com versão omitida não usarão essa versão.
ID do recurso da origem 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 de recurso.
Não aguarde a conclusão da operação de execução prolongada.
Nome ou ID do instantâneo de disco do sistema operacional.
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 regionais, use --target-regions.
Parâmetro opcional que especifica o modo a ser usado para replicação. Essa 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.
Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas 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. Formatar para cada zona de borda: <edge zone>,<os_des>,<lun1>,<lun1_des>,<lun2>,<lun2_des>.
Lista separada por espaço de regiões, zonas de borda, contagens de réplicas e tipos de armazenamento. Use <region>=<edge zone>[=<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. Se "--target-edge-zones None" for especificado, os locais estendidos de destino serão limpos.
Lista separada por espaço de 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 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 a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar 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 a verbosidade do registro em 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 reside a Versão da Imagem.
O nome da versão da imagem da galeria a ser excluída.
O nome da Galeria de Imagens Compartilhadas na qual reside a Definição de Imagem.
Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.
Não aguarde a conclusão da operação de execução prolongada.
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 a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar 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 a verbosidade do registro em 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 em --next-token argumento de um comando subsequente.
Token para especificar onde iniciar a paginação. Esse é o valor do token de uma resposta truncada anteriormente.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar 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 a verbosidade do registro em 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 galerias.
az sig image-version list-community [--gallery-image-definition]
[--ids]
[--location]
[--marker]
[--public-gallery-name]
[--show-next-marker]
[--subscription]Exemplos
Listar versões de imagem em uma comunidade de galerias.
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 da qual as versões da imagem devem ser listadas.
Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.
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 retornará 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, esse gerador começará a retornar os resultados do ponto em que 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 a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar 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 a verbosidade do registro em 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 da galeria (versão prévia).
Listar versões de imagem da VM em uma comunidade de galerias (recurso de visualização privada, entre em contato com a equipe da galeria de imagens da comunidade por email sigpmdev@microsoft.com para se registrar para visualização se você 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 imagem em uma comunidade de galerias.
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 da qual as versões da imagem devem ser listadas.
Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.
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 retornará 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, esse gerador começará a retornar os resultados do ponto em que 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 a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar 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 a verbosidade do registro em 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 compartilhadas diretamente com sua assinatura na definição de imagem e localização fornecidas.
az sig image-version list-shared --gallery-unique-name galleryUniqueName \
--gallery-image-definition MyImage --location myLocationListar versões de imagem em uma galeria compartilhadas diretamente com seu locatário na definição de imagem e localização fornecidas.
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 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 uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.
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 retornará 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, esse gerador começará a retornar os resultados do ponto em que 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 a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar 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 a verbosidade do registro em 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 a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar 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 a verbosidade do registro em 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 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 uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.
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.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar 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 a verbosidade do registro em 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
Obtenha uma versão de imagem em uma comunidade de galerias (versão prévia).
Obtenha uma versão de imagem em uma comunidade de galerias (recurso de visualização privada, entre em contato com a equipe da galeria de imagens da comunidade por email sigpmdev@microsoft.com para se registrar para visualização se você 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 de imagem em uma comunidade da 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 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 de nome 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. Formato:...
Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.
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.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar 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 a verbosidade do registro em 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 para 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 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 de nome 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. Formato: <MajorVersion>.<MinorVersion>.<Patch>.
O nome exclusivo da Galeria Compartilhada.
Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.
Localização. 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 a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.
az sig image-version undelete
Esse comando está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Restaurar a versão da imagem excluída suavemente.
A operação só será bem-sucedida se usada em uma Galeria com exclusão reversível.
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 com exclusão reversível
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 a remoção ou não dessa versão da imagem da galeria de regiões replicadas é permitida.
Localização. 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 prolongada.
Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar 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 a verbosidade do registro em log. 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=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 de imagem. Definir esse valor como true exclui a imagem da consideração e definir esse valor como false inclui a imagem a ser considerada.
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 término da vida útil de uma versão da imagem. A imagem ainda pode ser usada para criar máquinas virtuais após a data de término 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 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 valor de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.
Indique se a remoção ou não dessa versão da imagem da galeria de regiões replicadas é permitida.
Ao usar 'set' ou 'add', preserve literais de cadeia de caracteres em vez de tentar converter em JSON.
Não aguarde a conclusão da operação de execução prolongada.
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 regionais, 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 <region>=<edge zone>[=<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. 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 a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar 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 a verbosidade do registro em 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é ser criado com 'provisioningState' em 'Succeeded'.
Aguarde até que a condição atenda 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' é None.
Intervalo de sondagem em segundos.
Espera máxima em segundos.
Aguarde até que seja atualizado com provisioningState em 'Succeeded'.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.
