Partilhar via

Listar, atualizar e excluir recursos da galeria

  • Artigo

Você pode gerenciar seus recursos da Galeria de Computação do Azure (anteriormente conhecida como Galeria de Imagens Compartilhadas) usando a 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 público name e uniqueID da galeria que é compartilhada com você. Você pode usar o nome da galeria para consultar imagens que estão disponíveis na galeria.

Aqui 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

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

Galeria de Computação do Azure:

  • Description

Definição da imagem:

  • VCPUs recomendadas
  • Memória recomendada
  • Description
  • Data de fim de vida

Versão da imagem:

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

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á um tempo à medida que a imagem for 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 de imagem de ser usada como a 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 de imagem em ser considerada para a 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

Eliminar recursos

Você tem que excluir recursos na ordem inversa, excluindo a versão da imagem primeiro. Depois de excluir todas as versões da imagem, você pode excluir a definição da imagem. Depois de excluir todas as definições de imagem, você pode excluir a galeria.

Antes de excluir uma galeria compartilhada pela comunidade, você precisa usar 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 comunitárias

Importante

Galeria de Computação do Azure – as galerias da comunidade estão atualmente em PREVIEW e sujeitas aos Termos de Pré-visualização da Galeria de Computação do Azure - galeria da comunidade.

Para publicar uma galeria da comunidade, terá de configurar funcionalidades de pré-visualização na sua subscrição do Azure. A criação de VMs a partir de imagens da galeria da comunidade está aberta a todos os utilizadores do Azure.

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

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

Nota

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

Liste todas as definições de imagem que estão 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 um estado de VM, SO e SO.

 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

Listar versões de imagens compartilhadas em uma galeria da comunidade 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 – a galeria compartilhada direta está atualmente em VISUALIZAÇÃO e sujeita aos Termos de Visualização da Galeria de Computação do Azure.

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

Durante a visualização, você precisa criar uma nova galeria, com a propriedade sharingProfile.permissions definida como Groups. Ao usar a CLI para criar uma galeria, use o --permissions groups parâmetro. Você não pode usar uma galeria existente, a propriedade não pode ser atualizada no momento.

Para encontrar a uniqueID 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

Liste todas as definições de imagem que são compartilhadas diretamente com você, use az sig image-definition list-shared.

Neste exemplo, listamos todas as imagens na galeria no oeste dos EUA e, por nome, o ID exclusivo necessário para criar uma VM, um sistema operacional e um 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 imagens 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óximos passos