Výpis, aktualizace a odstranění prostředků galerie

  • Článek

Prostředky Galerie výpočetních prostředků Azure (dříve označované jako Sdílená galerie imagí) můžete spravovat pomocí Azure CLI nebo Azure PowerShellu.

Výpis galerií, které s vámi někdo sdílí

Zobrazit seznam galerií sdílených s vaším předplatným

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

Zobrazit seznam galerií sdílených s vaším tenantem

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

Výstup bude obsahovat veřejnost name a uniqueID galerii, která se s vámi sdílí. Název galerie můžete použít k dotazování na obrázky, které jsou dostupné prostřednictvím galerie.

Tady je příklad výstupu:

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

Aktualizace prostředků

Existují určitá omezení toho, co je možné aktualizovat. Můžete aktualizovat následující položky:

Galerie výpočetních prostředků Azure:

  • Popis

Definice obrázku:

  • Doporučené virtuální procesory
  • Doporučená paměť
  • Popis
  • Datum konce životnosti

Verze image:

  • Počet regionálních replik
  • Cílové oblasti
  • Vyloučení z nejnovější verze
  • Datum konce životnosti

Aktualizujte popis galerie pomocí příkazu (az sig update.

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

Aktualizujte popis definice image pomocí příkazu 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."

Aktualizujte verzi image a přidejte oblast, do které se má replikovat, pomocí příkazu az sig image-version update. Tato změna bude chvíli trvat, jakmile se image replikuje do nové oblasti.

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

Tento příklad ukazuje, jak pomocí příkazu az sig image-version update vyloučit tuto verzi image z použití jako nejnovější image.

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

Tento příklad ukazuje, jak použít az sig image-version update k zahrnutí této verze image do zvažování pro nejnovější image.

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

Odstranění prostředků

Nejprve musíte odstranit prostředky v obráceném pořadí odstraněním verze image. Po odstranění všech verzí imagí můžete definici image odstranit. Po odstranění všech definic obrázků můžete galerii odstranit.

Než budete moct odstranit komunitní sdílenou galerii, musíte pomocí příkazu az sig share reset ukončit sdílení galerie veřejně.

Odstranění verze image pomocí příkazu 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

Odstranění definice image pomocí příkazu az sig image-definition delete

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

Odstranění galerie pomocí příkazu az sig delete

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

Komunitní galerie

Důležité

Galerie Azure Compute – komunitní galerie jsou aktuálně ve verzi PREVIEW a podléhají podmínkám verze Preview pro galerii výpočetních prostředků Azure – komunitní galerie.

Pokud chcete publikovat komunitní galerii, budete muset ve svém předplatném Azure nastavit funkce ve verzi Preview. Vytváření virtuálních počítačů z imagí galerie komunity je otevřené všem uživatelům Azure.

Zobrazení seznamu vlastních galerií a výstup veřejných názvů pro galerie komunity:

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

Poznámka:

Jako koncový uživatel potřebujete k získání veřejného názvu galerie komunity aktuálně použít portál. Přejděte na Virtuální počítače>– Vytvoření>image>virtuálního počítače>Azure – Zobrazí se název veřejné galerie imagí komunity imagí.>>

Zobrazte seznam všech definic obrázků dostupných v galerii komunity pomocí příkazu az sig image-definition list-community.

V tomto příkladu zobrazíme seznam všech imagí v galerii ContosoImage v oblasti USA – západ a podle názvu jedinečné ID potřebné k vytvoření virtuálního počítače, operačního systému a stavu operačního systému.

 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

Výpis verzí imagí sdílených v galerii komunity pomocí příkazu 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

Přímé sdílené galerie

Důležité

Galerie výpočetních prostředků Azure – přímá sdílená galerie je aktuálně ve verzi PREVIEW a podléhá podmínkám verze Preview pro galerii azure Compute.

Pokud chcete publikovat obrázky do přímé sdílené galerie během náhledu, musíte se zaregistrovat na adrese https://aka.ms/directsharedgallery-preview. Vytváření virtuálních počítačů z přímé sdílené galerie je otevřené všem uživatelům Azure.

Během náhledu musíte vytvořit novou galerii s vlastností sharingProfile.permissions nastavenou na Groups. Při použití rozhraní příkazového řádku k vytvoření galerie použijte --permissions groups parametr. Nemůžete použít existující galerii, vlastnost se momentálně nedá aktualizovat.

Pokud chcete najít uniqueID galerii, která je s vámi sdílená, použijte příkaz az sig list-shared. V tomto příkladu hledáme galerie v oblasti USA – západ.

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

Zobrazte seznam všech definic obrázků, které jsou sdíleny přímo s vámi, použijte příkaz az sig image-definition list-shared.

V tomto příkladu zobrazíme seznam všech imagí v galerii v oblasti USA – západ a podle názvu jedinečné ID potřebné k vytvoření virtuálního počítače, operačního systému a stavu operačního systému.

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

Vypsat přímo sdílené verze imagí pomocí příkazu 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

Další kroky