Elencare, aggiornare ed eliminare le risorse della raccolta

  • Articolo

È possibile gestire le risorse di Azure Compute Gallery (in precedenza note come Raccolta immagini condivise) usando l'interfaccia della riga di comando di Azure o Azure PowerShell.

Elencare le raccolte condivise con l'utente

Elencare le raccolte condivise con la sottoscrizione.

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

Elencare le raccolte condivise con il tenant.

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

L'output conterrà il pubblico name e uniqueID la raccolta condivisa con l'utente. È possibile usare il nome della raccolta per eseguire query per le immagini disponibili tramite la raccolta.

Ecco l'output di esempio:

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

Aggiornare le risorse

Esistono alcune limitazioni su ciò che può essere aggiornato. Gli elementi seguenti possono essere aggiornati:

Raccolta di calcolo di Azure:

  • Descrizione

Definizione delle immagini:

  • VCPU consigliati
  • Memoria consigliata
  • Descrizione
  • Data di scadenza

Versione immagine:

  • Conteggio di repliche a livello di area
  • Aree di destinazione
  • Esclusione dalla versione più recente
  • Data di scadenza

Aggiornare la descrizione di una raccolta usando (az sig update).

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

Aggiornare la descrizione di una definizione di immagine 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."

Aggiornare una versione dell'immagine per aggiungere un'area da replicare con az sig image-version update. Questa modifica richiederà un po' mentre l'immagine viene replicata nella nuova area.

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

In questo esempio viene illustrato come usare az sig image-version update per escludere questa versione dell'immagine da usare come immagine più 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

In questo esempio viene illustrato come usare az sig image-version update per includere questa versione dell'immagine in essere considerata per l'immagine più 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

Eliminare le risorse

È necessario eliminare le risorse in ordine inverso eliminando prima la versione dell'immagine. Dopo aver eliminato tutte le versioni dell'immagine, è possibile eliminare la definizione dell'immagine. Dopo aver eliminato tutte le definizioni dell'immagine, è possibile eliminare la raccolta.

Prima di eliminare una raccolta condivisa dalla community, è necessario usare az sig share reset per interrompere la condivisione pubblica della raccolta.

Eliminare una versione dell'immagine 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

Eliminare una definizione di immagine usando az sig image-definition delete.

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

Eliminare una raccolta usando az sig delete.

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

Raccolte community

Importante

Raccolta di calcolo di Azure: le raccolte della community sono attualmente disponibili in ANTEPRIMA e soggette alle Condizioni per l’anteprima per la Raccolta di calcolo di Azure - raccolta della community.

Per pubblicare una raccolta community, è necessario configurare le funzionalità di anteprima nella sottoscrizione di Azure. La creazione di macchine virtuali dalle immagini della raccolta community è aperta a tutti gli utenti di Azure.

Per elencare le raccolte personalizzate e restituire i nomi pubblici per le raccolte della community:

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

Nota

Come utente finale, per ottenere il nome pubblico di una raccolta di community, è attualmente necessario usare il portale. Passare a Macchine> virtualiCreare>l'immagine>>della macchina> virtuale di AzureVedere tutto ilnome della raccoltacommunity immagini> della community.

Elencare tutte le definizioni di immagine disponibili in una raccolta community usando az sig image-definition list-community.

In questo esempio vengono elencate tutte le immagini nella raccolta ContosoImage negli Stati Uniti occidentali e in base al nome, l'ID univoco necessario per creare una macchina virtuale, un sistema operativo e uno stato del sistema operativo.

 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

Elencare le versioni dell'immagine condivise in una raccolta di community 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

Raccolte condivise dirette

Importante

Raccolta di calcolo di Azure: la raccolta condivisa diretta è attualmente disponibile in ANTEPRIMA ed è soggetta alle Condizioni per l’anteprima per la Raccolta di calcolo di Azure.

Per pubblicare immagini in una raccolta condivisa diretta durante l'anteprima, è necessario registrare in https://aka.ms/directsharedgallery-preview. La creazione di macchine virtuali da una raccolta condivisa diretta è aperta a tutti gli utenti di Azure.

Durante l'anteprima è necessario creare una nuova raccolta, con la proprietà sharingProfile.permissions impostata su Groups. Quando si usa l'interfaccia della riga di comando per creare una raccolta, usare il --permissions groups parametro . Non è possibile usare una raccolta esistente, la proprietà non può essere aggiornata.

Per trovare l'oggetto di una raccolta condivisa con l'utente uniqueID , usare az sig list-shared. In questo esempio si stanno cercando raccolte nell'area Stati Uniti occidentali.

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

Elencare tutte le definizioni di immagine condivise direttamente con l'utente, usare az sig image-definition list-shared.

In questo esempio vengono elencate tutte le immagini nella raccolta negli Stati Uniti occidentali e in base al nome, l'ID univoco necessario per creare una macchina virtuale, un sistema operativo e uno stato del sistema operativo.

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

Elencare le versioni dell'immagine direttamente condivise con 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

Passaggi successivi