Listar, atualizar e excluir recursos da galeria

  • Artigo

Você pode gerenciar seus recursos da Galeria de Computação do Azure (anteriormente conhecido como Galeria de Imagens Compartilhadas) usando o CLI do Azure ou o Azure PowerShell.

Listar galerias compartilhadas com você

Listar galerias compartilhadas com sua assinatura.

region=westus
az sig list-shared --location $region

Listar galerias compartilhadas com seu locatário.

region=westus
az sig list-shared --location $region --shared-to tenant

A saída conterá o name e o uniqueID públicos da galeria compartilhada com você. Você pode usar o nome da galeria para consultar imagens disponíveis por meio dela.

Abaixo está o exemplo de saída:

[
  {
    "location": "westus",
    "name": "1231b567-8a99-1a2b-1a23-123456789abc-MYDIRECTSHARED",
    "uniqueId": "/SharedGalleries/1231b567-8a99-1a2b-1a23-123456789abc-MYDIRECTSHARED"
  }
]

Atualizar recursos

Há algumas limitações sobre o que pode ser atualizado. Os seguintes itens podem ser atualizados:

Galeria de Computação do Azure:

  • Descrição

definição da imagem:

  • vCPUs recomendadas
  • Memória recomendada
  • Descrição
  • Data de fim da vida útil

Versão da imagem:

  • Contagem de réplicas regionais
  • Regiões de destino
  • Exclusão da mais recente
  • Data de fim da vida útil

Atualize a descrição de uma galeria usando (az sig update.

az sig update \
   --gallery-name myGallery \
   --resource-group myGalleryRG \
   --set description="My updated description."

Atualize a descrição de uma definição de imagem usando az sig image-definition update.

az sig image-definition update \
   --gallery-name myGallery\
   --resource-group myGalleryRG \
   --gallery-image-definition myImageDefinition \
   --set description="My updated description."

Atualize uma versão de imagem para adicionar uma região a ser replicada usando az sig image-version update. Essa alteração levará algum tempo, pois a imagem será replicada para a nova região.

az sig image-version update \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0 \
   --add publishingProfile.targetRegions  name=eastus

Este exemplo mostra como usar az sig image-version update para excluir essa versão da imagem para que não seja usada como imagem mais recente.

az sig image-version update \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0 \
   --set publishingProfile.excludeFromLatest=true

Este exemplo mostra como usar az sig image-version update para incluir essa versão da imagem considerada como imagem mais recente.

az sig image-version update \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0 \
   --set publishingProfile.excludeFromLatest=false

Excluir recursos

É necessário excluir os recursos na ordem inversa, excluindo a versão da imagem primeiro. Após excluir todas as versões da imagem, você poderá excluir a definição da imagem. Após excluir todas as definições da imagem, você poderá excluir a galeria.

Para excluir uma galeria compartilhada da comunidade, use a az sig share reset para parar de compartilhar a galeria publicamente.

Exclua uma versão de imagem usando az sig image-version delete.

az sig image-version delete \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0

Exclua uma definição de imagem usando az sig image-definition delete.

az sig image-definition delete \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition

Exclua uma galeria usando az sig delete.

az sig delete \
   --resource-group myGalleryRG \
   --gallery-name myGallery

Galerias da comunidade

Importante

Galeria de Computação do Azure – as galerias da comunidade estão atualmente em VERSÃO PRÉVIA e sujeitas aos Termos de versão prévia da Galeria de Computação do Azure – galeria da comunidade.

Para publicar uma galeria da comunidade, você precisará configurar a versão prévia dos recursos na sua assinatura do Azure. A criação de VMs da galeria da comunidade está aberta a todos os usuários do Azure.

Para listar suas próprias galerias e gerar os nomes públicos para suas galerias de comunidade:

az sig list --query [*]."{Name:name,PublicName:sharingProfile.communityGalleryInfo.publicNames}"

Observação

Como usuário final, para obter o nome público de uma galeria de comunidade, você precisa usar o portal. Acesse Máquinas virtuais>Criar>Máquina virtual do Azure>Imagem>Ver todas as imagens>Imagens da Comunidade>Nome da galeria pública.

Listar todas as definições de imagem disponíveis em uma galeria da comunidade usando az sig image-definition list-community.

Neste exemplo, listamos todas as imagens na galeria ContosoImage no Oeste dos EUA e, por nome, a ID exclusiva necessária para criar uma VM, um sistema operacional e um estado de sistema operacional.

 az sig image-definition list-community \
   --public-gallery-name "ContosoImages-1a2b3c4d-1234-abcd-1234-1a2b3c4d5e6f" \
   --location westus \
   --query [*]."{Name:name,ID:uniqueId,OS:osType,State:osState}" -o table

Liste as versões da imagem compartilhada em uma galeria usando az sig image-version list-community:

az sig image-version list-community \
   --location westus \
   --public-gallery-name "ContosoImages-1a2b3c4d-1234-abcd-1234-1a2b3c4d5e6f" \
   --gallery-image-definition myImageDefinition \
   --query [*]."{Name:name,UniqueId:uniqueId}" \
   -o table

Galerias compartilhadas diretas

Importante

Galeria de Computação do Azure – as galerias compartilhadas diretas estão atualmente em VERSÃO PRÉVIA e sujeitas aos Termos de Versão Prévia da Galeria de Computação do Azure.

Para publicar imagens em uma galeria compartilhada direta durante a versão prévia, você precisará se registrar em https://aka.ms/directsharedgallery-preview. A criação de VMs com base em uma galeria compartilhada direta está aberta a todos os usuários do Azure.

Durante a versão prévia, você precisará criar uma galeria, com a propriedade sharingProfile.permissions definida como Groups. Ao usar a CLI para criar uma galeria, use o parâmetro --permissions groups. Você não pode usar uma galeria existente, a propriedade não pode ser atualizada no momento.

Para localizar a uniqueID de uma galeria compartilhada com você, use az sig list-shared. Neste exemplo, estamos procurando galerias na região Oeste dos EUA.

region=westus
az sig list-shared --location $region --query "[].uniqueId" -o tsv

Para listar todas as definições de imagem compartilhadas diretamente com você, use az sig image-definition list-shared.

Neste exemplo, listamos todas as imagens na galeria no Oeste dos EUA por nome, a ID exclusiva necessária para criar uma VM, sistema operacional e estado do sistema operacional.

name="1a2b3c4d-1234-abcd-1234-1a2b3c4d5e6f-myDirectShared"
 az sig image-definition list-shared \
   --gallery-unique-name $name
   --location $region \
   --query [*]."{Name:name,ID:uniqueId,OS:osType,State:osState}" -o table

Liste versões de imagem compartilhadas diretamente com você usando az sig image-version list-shared:

imgDef="myImageDefinition"
az sig image-version list-shared \
   --location $region \
   --public-gallery-name $name \
   --gallery-image-definition $imgDef \
   --query [*]."{Name:name,UniqueId:uniqueId}" \
   -o table

Próximas etapas