Wyświetlanie, aktualizowanie i usuwanie zasobów galerii

  • Artykuł

Za pomocą interfejsu wiersza polecenia platformy Azure lub Azure PowerShell możesz zarządzać zasobami usługi Azure Compute Gallery (wcześniej znanej jako Shared Image Gallery).

Galerie list udostępnione Tobie

Wyświetlanie listy galerii udostępnionych subskrypcji.

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

Galerie listy udostępnione dzierżawie.

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

Dane wyjściowe będą zawierać publicznie name i uniqueID galerię udostępnioną Tobie. Możesz użyć nazwy galerii do wykonywania zapytań dotyczących obrazów, które są dostępne za pośrednictwem galerii.

Oto przykładowe dane wyjściowe:

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

Aktualizowanie zasobów

Istnieją pewne ograniczenia dotyczące tego, co można zaktualizować. Można zaktualizować następujące elementy:

Galeria usługi Azure Compute:

  • Opis

Definicja obrazu:

  • Zalecane procesory wirtualne
  • Zalecana pamięć
  • Opis
  • Data zakończenia życia

Wersja obrazu:

  • Liczba replik regionalnych
  • Regiony docelowe
  • Wykluczenie z najnowszej wersji
  • Data zakończenia życia

Zaktualizuj opis galerii przy użyciu polecenia (az sig update).

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

Zaktualizuj opis definicji obrazu przy użyciu polecenia 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."

Zaktualizuj wersję obrazu, aby dodać region do replikacji przy użyciu polecenia az sig image-version update. Ta zmiana zajmie trochę czasu, gdy obraz zostanie zreplikowany do nowego regionu.

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

W tym przykładzie pokazano, jak używać polecenia az sig image-version update , aby wykluczyć tę wersję obrazu z użycia jako najnowszy obraz.

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

W tym przykładzie pokazano, jak za pomocą polecenia az sig image-version update uwzględnić tę wersję obrazu w przypadku najnowszego obrazu.

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

Usuwanie zasobów

Musisz usunąć zasoby w odwrotnej kolejności, usuwając najpierw wersję obrazu. Po usunięciu wszystkich wersji obrazu można usunąć definicję obrazu. Po usunięciu wszystkich definicji obrazów można usunąć galerię.

Przed usunięciem galerii udostępnionej społeczności należy użyć polecenia az sig share reset , aby zatrzymać udostępnianie galerii publicznie.

Usuń wersję obrazu przy użyciu polecenia 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

Usuń definicję obrazu przy użyciu polecenia az sig image-definition delete.

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

Usuń galerię przy użyciu polecenia az sig delete.

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

Galerie społeczności

Ważne

Galeria usługi Azure Compute — galerie społeczności są obecnie dostępne w wersji zapoznawczej i podlegają warunkom wersji zapoznawczej galerii usługi Azure Compute Gallery — galeria społeczności.

Aby opublikować galerię społeczności, musisz skonfigurować funkcje w wersji zapoznawczej w subskrypcji platformy Azure. Tworzenie maszyn wirtualnych na podstawie obrazów galerii społeczności jest otwarte dla wszystkich użytkowników platformy Azure.

Aby wyświetlić listę własnych galerii i wyświetlić publiczne nazwy galerii społeczności:

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

Uwaga

Jako użytkownik końcowy, aby uzyskać publiczną nazwę galerii społeczności, obecnie musisz użyć portalu. Przejdź do pozycji Maszyny> wirtualneTworzenie>obrazu> maszyny >wirtualnej platformy AzureZobacz wszystkie obrazy>Obrazy społeczności>Nazwa galerii publicznej.

Wyświetl listę wszystkich definicji obrazów dostępnych w galerii społeczności przy użyciu polecenia az sig image-definition list-community.

W tym przykładzie wymieniono wszystkie obrazy w galerii ContosoImage w regionie Zachodnie stany USA i według nazwy unikatowy identyfikator potrzebny do utworzenia stanu maszyny wirtualnej, systemu operacyjnego i systemu operacyjnego.

 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

Wyświetlanie listy wersji obrazów udostępnionych w galerii społeczności przy użyciu polecenia 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

Bezpośrednie galerie udostępnione

Ważne

Galeria usługi Azure Compute — bezpośrednia galeria udostępniona jest obecnie w wersji zapoznawczej i podlega warunkom wersji zapoznawczej galerii obliczeń platformy Azure.

Aby opublikować obrazy w bezpośredniej galerii udostępnionej podczas korzystania z wersji zapoznawczej, musisz zarejestrować się pod adresem https://aka.ms/directsharedgallery-preview. Tworzenie maszyn wirtualnych z bezpośredniej galerii udostępnionej jest otwarte dla wszystkich użytkowników platformy Azure.

W wersji zapoznawczej musisz utworzyć nową galerię z właściwością sharingProfile.permissions ustawioną na Groups. W przypadku tworzenia galerii za pomocą interfejsu wiersza polecenia użyj parametru --permissions groups . Nie można użyć istniejącej galerii. Obecnie nie można zaktualizować właściwości.

Aby znaleźć uniqueID galerię udostępnioną Tobie, użyj polecenia az sig list-shared. W tym przykładzie szukamy galerii w regionie Zachodnie stany USA.

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

Wyświetl listę wszystkich definicji obrazów, które są udostępniane bezpośrednio Tobie, użyj polecenia az sig image-definition list-shared.

W tym przykładzie wymieniono wszystkie obrazy w galerii w regionie Zachodnie stany USA i według nazwy unikatowy identyfikator potrzebny do utworzenia stanu maszyny wirtualnej, systemu operacyjnego i systemu operacyjnego.

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

Wyświetl listę wersji obrazów bezpośrednio udostępnionych za pomocą polecenia 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

Następne kroki