Partilhar via


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

Adicionar 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/MyManagedImage

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

Adicionar 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/MyOSDisk

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

Adicione 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/MyOsDiskSnapshot

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

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

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

Você 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 1

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

Adicione 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,EastUSDiskEncryptionSet2

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

Adicione 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,WestUSDiskEncryptionSet2

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

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

Adicione 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:00

Parâmetros Obrigatórios

--gallery-image-definition -i

Definição de imagem de galeria.

--gallery-image-version -e

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>

--gallery-name -r

Nome da galeria.

--resource-group -g

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

Parâmetros Opcionais

--allow-replicated-location-deletion

Indique se é permitida ou não a remoção desta versão da imagem da galeria das regiões replicadas.

valores aceites: false, true
--data-snapshot-luns

Números de unidades lógicas (delimitados por espaço) de instantâneos de disco de dados.

--data-snapshots

Nomes ou IDs (delimitados por espaço) de instantâneos de disco de dados.

--data-vhds-luns

Números de unidades lógicas (delimitados por espaço) de URIs VHD de origem de discos de dados.

--data-vhds-sa --data-vhds-storage-accounts

Nomes ou IDs (delimitados por espaço) de contas de armazenamento de URIs VHD de origem de discos de dados.

--data-vhds-uris

URIs VHD de origem (delimitados por espaço) de discos de dados.

--end-of-life-date

A data do fim da vida útil, por exemplo, «2020-12-31».

--exclude-from-latest

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.

valores aceites: false, true
--image-version

ID do recurso da fonte da versão da imagem da galeria.

--location -l

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

--managed-image

Nome da imagem (se estiver no mesmo grupo de recursos) ou ID do recurso.

--no-wait

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

valor predefinido: False
--os-snapshot

Nome ou ID do instantâneo de disco do SO.

--os-vhd-storage-account

Nome ou ID da conta de armazenamento do URI VHD de origem do disco do sistema operacional.

--os-vhd-uri

URI VHD de origem do disco do sistema operacional.

--replica-count

O número padrão de réplicas a serem criadas por região. Para definir contagens de replicação regional, use --target-regions.

--replication-mode

Parâmetro opcional que especifica o modo a ser usado para replicação. Esta propriedade não é atualizável.

valores aceites: Full, Shallow
--storage-account-type

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.

valores aceites: Premium_LRS, Standard_LRS, Standard_ZRS
--tags

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

--target-edge-zone-encryption --zone-encryption

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

--target-edge-zones

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.

--target-region-cvm-encryption

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.

--target-region-encryption

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.

--target-regions

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.

--virtual-machine

ID do recurso da origem da VM.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

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

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az 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

--gallery-image-definition --gallery-image-name -i

O nome da definição de imagem da galeria na qual a Versão da Imagem reside.

--gallery-image-version --gallery-image-version-name -e

O nome da versão da imagem da galeria a ser excluída.

--gallery-name -r

O nome da Galeria de Imagens Compartilhadas na qual a Definição de Imagem reside.

--ids

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

--no-wait

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

valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

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

--subscription

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

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

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

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az 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

--gallery-image-definition --gallery-image-name -i

Definição de imagem de galeria.

--gallery-name -r

Nome da galeria.

--resource-group -g

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

Parâmetros Opcionais

--max-items

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

--next-token

Token para especificar por onde começar a paginar. Este é o valor de token de uma resposta truncada anteriormente.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

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

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

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

Parâmetros Opcionais

--gallery-image-definition -i

O nome da definição de imagem da galeria da comunidade a partir da qual as versões da imagem devem ser listadas.

--ids

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

--location -l

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

--marker

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.

--public-gallery-name

O nome público da galeria da comunidade.

--show-next-marker

Mostrar nextMarker no resultado quando especificado.

--subscription

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

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

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

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az sig image-version list-community (image-gallery extensão)

Experimental

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 myLocation

Parâmetros Opcionais

--gallery-image-definition -i

O nome da definição de imagem da galeria da comunidade a partir da qual as versões da imagem devem ser listadas.

--ids

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

--location -l

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

--marker

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.

--public-gallery-name

O nome público da galeria da comunidade.

--show-next-marker

Mostrar nextMarker no resultado quando especificado.

--subscription

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

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

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

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

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

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

Parâmetros Opcionais

--gallery-image-definition -i

O nome da Definição de Imagem da Galeria Compartilhada a partir da qual as Versões de Imagem devem ser listadas.

--gallery-unique-name

O nome exclusivo da Galeria Compartilhada.

--ids

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

--location -l

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

--marker

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.

--shared-to

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.

valores aceites: tenant
--show-next-marker

Mostrar nextMarker no resultado quando especificado.

--subscription

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

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

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

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az 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

--gallery-image-definition -i

Definição de imagem de galeria.

--gallery-image-version -e

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>

--gallery-name -r

Nome da galeria.

--resource-group -g

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

Parâmetros Opcionais

--expand

A expressão expand a ser aplicada na operação, por exemplo, 'ReplicationStatus'.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

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

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az 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

--gallery-image-definition --gallery-image-name -i

O nome da definição de imagem da galeria da comunidade a partir da qual as versões da imagem devem ser listadas.

--gallery-image-version --gallery-image-version-name -e

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>

--ids

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

--location -l

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

--public-gallery-name

O nome público da galeria da comunidade.

--subscription

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

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

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

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az sig image-version show-community (image-gallery extensão)

Experimental

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 myLocation

Parâmetros Opcionais

--gallery-image-definition -i

O nome da definição de imagem da galeria da comunidade a partir da qual as versões da imagem devem ser listadas.

--gallery-image-version -e

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

--ids

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

--location -l

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

--public-gallery-name

O nome público da galeria da comunidade.

--subscription

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

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

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

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

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

Parâmetros Opcionais

--gallery-image-definition --gallery-image-name -i

O nome da Definição de Imagem da Galeria Compartilhada a partir da qual as Versões de Imagem devem ser listadas.

--gallery-image-version --gallery-image-version-name -e

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

--gallery-unique-name

O nome exclusivo da Galeria Compartilhada.

--ids

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

--location -l

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

--subscription

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

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

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

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az sig image-version undelete

Pré-visualizar

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

Parâmetros Obrigatórios

--gallery-image-definition -i

Definição de imagem de galeria.

--gallery-image-version -e

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>

--gallery-name -r

Nome da galeria.

--resource-group -g

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

Parâmetros Opcionais

--allow-replicated-location-deletion

Indique se é permitida ou não a remoção desta versão da imagem da galeria das regiões replicadas.

valores aceites: false, true
--location -l

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

--no-wait

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

valor predefinido: False
--tags

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

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

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

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

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

Alterar 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=1

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

Replicar 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=true

Altere 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=true

Altere 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:00

Permitir 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=true

Parâmetros Obrigatórios

--gallery-image-definition -i

Definição de imagem de galeria.

--gallery-image-version -e

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>

--gallery-name -r

Nome da galeria.

--resource-group -g

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

Parâmetros Opcionais

--add

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

valor predefinido: []
--allow-replicated-location-deletion

Indique se é permitida ou não a remoção desta versão da imagem da galeria das regiões replicadas.

valores aceites: false, true
--force-string

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

valor predefinido: False
--no-wait

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

valor predefinido: False
--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OR --remove propertyToRemove.

valor predefinido: []
--replica-count

O número padrão de réplicas a serem criadas por região. Para definir contagens de replicação regional, use --target-regions.

--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=<value>.

valor predefinido: []
--target-edge-zones

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.

--target-regions

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

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

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

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

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

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

Parâmetros Obrigatórios

--gallery-image-definition -i

Definição de imagem de galeria.

--gallery-image-version -e

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>

--gallery-name -r

Nome da galeria.

--resource-group -g

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

Parâmetros Opcionais

--created

Aguarde até ser criado com 'provisioningState' em 'Succeeded'.

valor predefinido: False
--custom

Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Aguarde até ser excluído.

valor predefinido: False
--exists

Aguarde até que o recurso exista.

valor predefinido: False
--expand

A expressão expand a ser aplicada na operação. O valor padrão 'ReplicationStatus' é Nenhum.

--interval

Intervalo de sondagem em segundos.

valor predefinido: 30
--timeout

Espera máxima em segundos.

valor predefinido: 3600
--updated

Aguarde até ser atualizado com provisioningState em 'Succeeded'.

valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

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

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.