Condividi tramite

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

Elenca le raccolte condivise con la sottoscrizione.

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

Elenca 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 sulle immagini disponibili tramite la raccolta.

Di seguito è riportato un esempio di output:

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

Aggiornare le risorse

Esistono alcune limitazioni relative a ciò che è possibile aggiornare. È possibile aggiornare gli elementi seguenti:

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 in cui eseguire la replica usando az sig image-version update. Questa modifica richiederà del tempo perché 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

Questo esempio illustra come usare az sig image-version update per escludere questa versione dell'immagine dall'uso 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

Questo esempio illustra come usare az sig image-version update per includere questa versione dell'immagine da considerare 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 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 poter eliminare una raccolta condivisa della 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 della 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 della 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 community, è attualmente necessario usare il portale. Passare a Macchine virtuali>Crea>Macchina virtuale di Azure>Immagine>Visualizza tutte le immagini>Immagini della community>Nome della raccolta pubblica.

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 in 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 delle immagini condivise in una raccolta 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 registrarsi in https://aka.ms/directsharedgallery-preview. La creazione di macchine virtuali dalla 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 parametro --permissions groups. Non è possibile usare una raccolta esistente, la proprietà non può essere aggiornata.

Per trovare il valore uniqueID di una raccolta condivisa con l'utente, 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 delle immagini direttamente condivise 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

Passaggi successivi