Auflisten, Aktualisieren und Löschen von Katalogressourcen

  • Artikel

Sie können Ihre Azure Compute Gallery-Ressourcen (früher als Shared Image Gallery bezeichnet) mithilfe der Azure CLI oder Azure PowerShell verwalten.

Auflisten der für Sie freigegebenen Kataloge

Listen Sie Kataloge auf, die für Ihr Abonnement freigegeben wurden.

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

Listen Sie Kataloge auf, die für Ihren Mandanten freigegeben wurden.

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

Die Ausgabe enthält die öffentlichen Namen (name) und die uniqueID des Katalogs, der für Sie freigegeben ist. Sie können den Namen des Katalogs verwenden, um nach Images zu suchen, die über diesen Katalog verfügbar sind.

Hier ist eine Beispielausgabe:

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

Aktualisieren von Ressourcen

Es gibt Einschränkungen, welche Elemente aktualisiert werden können. Die folgenden Elemente können aktualisiert werden:

Azure Compute Gallery:

  • BESCHREIBUNG

Imagedefinition:

  • Empfohlene vCPUs
  • Empfohlener Arbeitsspeicher
  • BESCHREIBUNG
  • Datum für Ende des Lebenszyklus

Imageversion:

  • Anzahl regionaler Replikate
  • Zielregionen
  • Ausschluss aus neuester Version
  • Datum für Ende des Lebenszyklus

Aktualisieren Sie die Beschreibung eines Katalogs mit (az sig update.

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

Aktualisieren Sie die Beschreibung einer Imagedefinition mit 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."

Aktualisieren Sie eine Imageversion zum Hinzufügen einer Region als Replikationsziel mit az sig image-version update. Diese Änderung wird einige Zeit in Anspruch nehmen, da das Image in eine neue Region repliziert wird.

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 diesem Beispiel wird gezeigt, wie Sie mit az sig image-version update dafür sorgen können, dass diese Imageversion nicht als das neueste Image verwendet wird.

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

Dieses Beispiel zeigt, wie az sig image-version update verwendet wird, um diese Imageversion in die Berücksichtigung als neuestes Image einzubeziehen.

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

Löschen von Ressourcen

Ressourcen müssen in umgekehrter Reihenfolge gelöscht werden, beginnend mit der Imageversion. Nachdem alle Imageversionen gelöscht sind, können Sie die Imagedefinition löschen. Nachdem alle Imagedefinitionen gelöscht sind, können Sie den Katalog löschen.

Bevor Sie einen freigegebenen Communitykatalog löschen können, müssen Sie az sig share reset verwenden, um die Freigabe des Katalogs öffentlich zu beenden.

Löschen Sie eine Imageversion mit 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

Löschen Sie eine Imagedefinition mit az sig image-definition delete.

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

Löschen Sie einen Katalog mit az sig delete.

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

Communitykataloge

Wichtig

Azure Compute Gallery – Communitykataloge befinden sich derzeit in der VORSCHAU und unterliegen den Vorschaubedingungen für Azure Compute Gallery – Communitykatalog.

Um einen Communitykatalog zu veröffentlichen, müssen Sie Previewfunktionen in Ihrem Azure-Abonnement einrichten. Das Erstellen von VMs aus Communitykatalog-Images ist für alle Azure-Benutzer möglich.

So listen Sie Ihre eigenen Kataloge auf, und geben die öffentlichen Namen für Ihre Communitykataloge aus:

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

Hinweis

Als Endbenutzer müssen Sie derzeit das Portal verwenden, um den öffentlichen Namen eines Communitykatalogs abzurufen. Wechseln Sie zu Virtuelle Computer>Erstellen>Virtueller Azure-Computer>Image>Alle Images anzeigen>Communityimages>Öffentlicher Katalogname.

Listet alle Imagedefinitionen auf, die in einem Communitykatalog mit az sig image-definition list-community verfügbar sind.

In diesem Beispiel werden alle Images im ContosoImage-Katalog in USA, Westen und nach Name aufgeführt, die eindeutige ID, die zum Erstellen einer VM, eines Betriebssystems und des Betriebssystemstatus erforderlich ist.

 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

Listen Sie die in einem Communitykatalog freigegebenen Imageversionen mithilfe von az sig image-version list-community auf:

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

Direkt freigegebene Kataloge

Wichtig

„Azure Compute Gallery – direkt freigegebener Katalog“ befindet sich derzeit in der Vorschauphase und unterliegt den Vorschaubedingungen für Azure Compute Gallery.

Um Images während der Vorschau in einem direkt freigegebenen Katalog zu veröffentlichen, müssen Sie sich bei https://aka.ms/directsharedgallery-preview registrieren. Die Erstellung von VMs aus einem direkt freigegebenen Katalog steht allen Azure-Benutzern offen.

Während der Vorschau müssen Sie einen neuen Katalog erstellen, bei dem die Eigenschaft sharingProfile.permissions auf Groups festgelegt ist. Wenn Sie zum Erstellen eines Katalogs die CLI nutzen, verwenden Sie den Parameter --permissions groups. Sie können keinen vorhandenen Katalog verwenden, die Eigenschaft kann zurzeit nicht aktualisiert werden.

Verwenden Sie az sig list-shared, um die uniqueID eines Katalogs zu ermitteln, der für Sie freigegeben ist. In diesem Beispiel suchen wir Kataloge in der Region „USA, Westen“.

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

Um alle Imagedefinitionen aufzulisten, die direkt für Sie freigegeben wurden, verwenden Sie az sig image-definition list-shared.

In diesem Beispiel werden alle Katalogimages in USA, Westen nach dem Namen, der für die Erstellung einer VM erforderlichen eindeutigen ID, dem Betriebssystem und dem Betriebssystemstatus aufgelistet.

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

Listen Sie mit az sig image-version list-shared Imageversionen auf, die direkt für Sie freigegeben wurden:

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

Nächste Schritte