Listar, atualizar e excluir recursos da galeria

Artigo
10/15/2024

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"
  }
]

Listar galerias compartilhadas com uma assinatura.

GET
https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{rgName}/providers/Microsoft.Compute/Locations/{location}/SharedGalleries?api-version=2020-09-30

A resposta deve ser semelhante a esta:

{	 
"value": [ 
{ 
"identifier": { 
"uniqueId": "/SharedGalleries/{SharedGalleryUniqueName}"         
}, 
"name": "galleryuniquename1", 
   		"type": "Microsoft. Compute/sharedGalleries", 
   		"location": "location" 
  	}, 
  	{ 
"identifier": { 
"uniqueName": "/SharedGalleries/{SharedGalleryUniqueName}"       
}, 
"name": "galleryuniquename2", 
"type": "Microsoft. Compute/sharedGalleries", 
"location": "location" 
  	} 
], 
}

Listar as galerias compartilhadas com um locatário.

GET
https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/Locations/{location}/SharedGalleries?api-version=2020-09-30&sharedTo=tenant

A resposta deve ser semelhante a esta:

{	 
"value": [ 
{ 
"identifier": { 
"uniqueName": "/SharedGalleries/{SharedGalleryUniqueName}"         
}, 
"name": "galleryuniquename1", 
   		"type": "Microsoft. Compute/sharedGalleries", 
   		"location": "location" 
  	}, 
  	{ 
"identifier": { 
"uniqueName": "/SharedGalleries/{SharedGalleryUniqueName}"       
}, 
"name": "galleryuniquename2", 
"type": "Microsoft. Compute/sharedGalleries", 
"location": "location" 
  	} 
], 
} 

---

## List your gallery information

### [CLI](#tab/cli)

Get the location, status and other information about your image galleries using [az sig list](/cli/azure/sig#az-sig-list).

```azurecli-interactive 
az sig list -o table

Listar as definições de imagem

Liste as definições de imagem na sua galeria, incluindo informações sobre o tipo e o status do sistema operacional, usando a az sig image-definition list.

az sig image-definition list --resource-group myGalleryRG --gallery-name myGallery -o table

Listar as versões de imagem

Liste as versões de imagem na sua galeria usando a az sig image-version list:

az sig image-version list --resource-group myGalleryRG --gallery-name myGallery --gallery-image-definition myImageDefinition -o table

Obter uma versão específica da imagem

Obtenha a ID de uma versão de imagem específica em sua galeria usando az sig image-version show.

az sig image-version show \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0 \
   --query "id"

Liste todas as galerias por nome.

$galleries = Get-AzResource -ResourceType Microsoft.Compute/galleries
$galleries.Name

Liste todas as definições de imagem por nome.

$imageDefinitions = Get-AzResource -ResourceType Microsoft.Compute/galleries/images
$imageDefinitions.Name

Liste todas as versões de imagem por nome.

$imageVersions = Get-AzResource -ResourceType Microsoft.Compute/galleries/images/versions
$imageVersions.Name

Excluir uma versão de imagem. Este exemplo exclui a versão da imagem chamada 1.0.0.

Remove-AzGalleryImageVersion `
   -GalleryImageDefinitionName myImageDefinition `
   -GalleryName myGallery `
   -Name 1.0.0 `
   -ResourceGroupName myGalleryRG

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

CLI
PowerShell

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

Para atualizar a descrição de uma galeria, use Update-AzGallery.

Update-AzGallery `
   -Name $gallery.Name ` 
   -ResourceGroupName $resourceGroup.Name

Este exemplo mostra como usar Update-AzGalleryImageDefinition para atualizar a data de fim da vida útil da nossa definição de imagem.

Update-AzGalleryImageDefinition `
   -GalleryName $gallery.Name `
   -Name $galleryImage.Name `
   -ResourceGroupName $resourceGroup.Name `
   -EndOfLifeDate 01/01/2030

Este exemplo mostra como usar Update-AzGalleryImageVersion para excluir essa versão da imagem de ser usada como a imagem mais recente.

Update-AzGalleryImageVersion `
   -GalleryImageDefinitionName $galleryImage.Name `
   -GalleryName $gallery.Name `
   -Name $galleryVersion.Name `
   -ResourceGroupName $resourceGroup.Name `
   -PublishingProfileExcludeFromLatest

Este exemplo mostra como usar Update-AzGalleryImageVersion para incluir essa versão da imagem sendo considerada para a imagem mais recente.

Update-AzGalleryImageVersion `
   -GalleryImageDefinitionName $galleryImage.Name `
   -GalleryName $gallery.Name `
   -Name $galleryVersion.Name `
   -ResourceGroupName $resourceGroup.Name `
   -PublishingProfileExcludeFromLatest:$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.

CLI
PowerShell

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

$resourceGroup = "myResourceGroup"
$gallery = "myGallery"
$imageDefinition = "myImageDefinition"
$imageVersion = "myImageVersion"

Remove-AzGalleryImageVersion `
   -GalleryImageDefinitionName $imageDefinition `
   -GalleryName $gallery `
   -Name $imageVersion `
   -ResourceGroupName $resourceGroup

Remove-AzGalleryImageDefinition `
   -ResourceGroupName $resourceGroup `
   -GalleryName $gallery `
   -GalleryImageDefinitionName $imageDefinition

Remove-AzGallery `
   -Name $gallery `
   -ResourceGroupName $resourceGroup

Remove-AzResourceGroup -Name $resourceGroup

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

Crie uma definição de imagem e uma versão de imagem.
Crie uma VM com base em uma imagem generalizada ou especializada em uma Galeria de Computação do Azure.

Compartilhar via