Udostępnij za pośrednictwem

Wyświetlanie, aktualizowanie i usuwanie zasobów galerii

  • Artykuł

Za pomocą interfejsu wiersza polecenia platformy Azure lub programu Azure PowerShell możesz zarządzać zasobami galerii obliczeń platformy Azure (dawniej nazywanej galerią obrazów udostępnionych).

Galerie list udostępnione Tobie

Galerie list udostępnione twojej subskrypcji.

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

Galerie list udostępnione dzierżawie.

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

Dane wyjściowe będą zawierać publiczną 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 w 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 potrwa chwilę, 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żyć 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 użyć polecenia az sig image-version update , aby uwzględnić tę wersję obrazu w rozważaniu dla 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żesz usunąć galerię.

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

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 — galerii społeczności.

Aby opublikować galerię społeczności, musisz skonfigurować funkcje w wersji zapoznawczej w ramach 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 wirtualne Tworzenie>obrazu maszyny wirtualnej platformy>>>Azure Zobacz 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 wyświetlamy listę wszystkich obrazów w galerii ContosoImage w regionie Zachodnie stany USA i według nazwy unikatowy identyfikator potrzebny do utworzenia maszyny wirtualnej, systemu operacyjnego i stanu 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 dostępna w wersji zapoznawczej i podlega warunkom wersji zapoznawczej galerii obliczeń platformy Azure.

Aby opublikować obrazy w bezpośredniej galerii udostępnionej w 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.

Podczas korzystania z wersji zapoznawczej musisz utworzyć nową galerię z właściwością sharingProfile.permissions ustawioną na Groups. W przypadku tworzenia galerii przy użyciu interfejsu wiersza polecenia użyj parametru --permissions groups . Nie można użyć istniejącej galerii. Nie można obecnie 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 wyświetlamy listę wszystkich obrazów w galerii w regionie Zachodnie stany USA i według nazwy unikatowy identyfikator potrzebny do utworzenia maszyny wirtualnej, systemu operacyjnego i stanu 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