Lista, uppdatera och ta bort galleriresurser

  • Artikel

Du kan hantera dina Azure Compute Gallery-resurser (kallades tidigare Shared Image Gallery) med hjälp av Azure CLI eller Azure PowerShell.

Lista gallerier som delas med dig

Lista gallerier som delas med din prenumeration.

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

Visa en lista över gallerier som delas med din klientorganisation.

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

Utdata innehåller allmänheten name och uniqueID galleriet som delas med dig. Du kan använda namnet på galleriet för att fråga efter bilder som är tillgängliga via galleriet.

Här är exempel på utdata:

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

Uppdatera resurser

Det finns vissa begränsningar för vad som kan uppdateras. Följande objekt kan uppdateras:

Azure Compute Gallery:

  • Description

Bilddefinition:

  • Rekommenderade vCPU:er
  • Rekommenderat minne
  • Description
  • Slutdatum

Bildversion:

  • Antal regionala repliker
  • Målregioner
  • Undantag från senaste
  • Slutdatum

Uppdatera beskrivningen av ett galleri med hjälp av (az sig update.

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

Uppdatera beskrivningen av en bilddefinition med 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."

Uppdatera en avbildningsversion för att lägga till en region som ska replikeras till med hjälp av az sig image-version update. Den här ändringen tar en stund när avbildningen replikeras till den nya regionen.

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

Det här exemplet visar hur du använder az sig image-version update för att undanta den här avbildningsversionen från att användas som den senaste avbildningen.

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

Det här exemplet visar hur du använder az sig image-version update för att inkludera den här avbildningsversionen i att övervägas för den senaste avbildningen.

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

Ta bort resurser

Du måste ta bort resurser i omvänd ordning genom att först ta bort avbildningsversionen. När du har tagit bort alla avbildningsversioner kan du ta bort bilddefinitionen. När du har tagit bort alla bilddefinitioner kan du ta bort galleriet.

Innan du kan ta bort ett delat community-galleri måste du använda az sig-resursåterställning för att sluta dela galleriet offentligt.

Ta bort en avbildningsversion med 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

Ta bort en bilddefinition med az sig image-definition delete.

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

Ta bort ett galleri med az sig delete.

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

Community-gallerier

Viktigt

Azure Compute Gallery – communitygallerier är för närvarande i förhandsversion och omfattas av förhandsversionsvillkoren för Azure Compute Gallery – communitygalleri.

Om du vill publicera ett community-galleri måste du konfigurera förhandsgranskningsfunktioner i din Azure-prenumeration. Att skapa virtuella datorer från communitygalleribilder är öppet för alla Azure-användare.

Så här listar du dina egna gallerier och matar ut de offentliga namnen för dina communitygallerier:

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

Anteckning

Som slutanvändare måste du för närvarande använda portalen för att få det offentliga namnet på ett communitygalleri. Gå till Virtuella datorer>Skapa>en virtuell Azure-dator>Avbildning>Se alla bilder>Community Images>Offentligt gallerinamn.

Visa en lista över alla bilddefinitioner som är tillgängliga i ett community-galleri med az sig image-definition list-community.

I det här exemplet listar vi alla avbildningar i ContosoImage-galleriet i USA, västra och efter namn, det unika ID som behövs för att skapa en virtuell dator, ett operativsystem och ett operativsystem.

 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

Visa en lista över avbildningsversioner som delas i ett community-galleri med 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

Direkt delade gallerier

Viktigt

Azure Compute Gallery – direktdelade galleri finns för närvarande i förhandsversion och omfattas av förhandsversionsvillkoren för Azure Compute Gallery.

Om du vill publicera bilder till ett direkt delat galleri under förhandsversionen måste du registrera dig på https://aka.ms/directsharedgallery-preview. Att skapa virtuella datorer från ett direkt delat galleri är öppet för alla Azure-användare.

Under förhandsversionen måste du skapa ett nytt galleri med egenskapen sharingProfile.permissions inställd på Groups. När du använder CLI för att skapa ett galleri använder du parametern --permissions groups . Du kan inte använda ett befintligt galleri. Egenskapen kan för närvarande inte uppdateras.

Om du vill hitta galleriet uniqueID som delas med dig använder du az sig list-shared. I det här exemplet letar vi efter gallerier i regionen USA, västra.

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

Visa en lista över alla bilddefinitioner som delas direkt med dig. Använd az sig image-definition list-shared.

I det här exemplet listar vi alla avbildningar i galleriet i USA, västra och efter namn, det unika ID som behövs för att skapa en virtuell dator, ett operativsystem och ett operativsystem.

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

Visa en lista över bildversioner som delas direkt med 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

Nästa steg