Dela via

Lista, uppdatera och ta bort galleriresurser

  • Artikel

Du kan hantera dina Azure Compute Gallery-resurser (tidigare kallat Delat bildgalleri) med hjälp av Azure CLI eller Azure PowerShell.

Lista gallerier som delas med dig

Visa en lista över 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 galleriets namn 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:

  • beskrivning

Bilddefinition:

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

Avbildningsversion:

  • Antal regionala repliker
  • Målregioner
  • Exkludering 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 ta bort avbildningsversionen först. 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 galleri för communityn måste du använda az sig share reset 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 – communitygalleriet.

Om du vill publicera ett communitygalleri måste du konfigurera förhandsversionsfunktioner i din Azure-prenumeration. Det är öppet för alla Azure-användare att skapa virtuella datorer från communitygalleribilder.

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

Kommentar

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 communitygalleri med az sig image-definition list-community.

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

 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

Lista bildversioner som delas i ett communitygalleri 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

Direktdelade gallerier

Viktigt!

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

Om du vill publicera avbildningar 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 ett uniqueID galleri 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 med namn det unika ID som behövs för att skapa en virtuell dator, operativsystem och operativsystemtillstånd.

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