ギャラリーのリソースを一覧表示、更新、削除する

  • [アーティクル]

Azure CLI または Azure PowerShell を使って、Azure Compute Gallery (旧称 Shared Image Gallery) のリソースを管理できます。

共有されているギャラリーを一覧表示する

サブスクリプションと共有されているギャラリーを一覧表示します。

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

テナントと共有されているギャラリーを一覧表示します。

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

出力には、共有されているギャラリーのパブリック name と uniqueID が含まれます。 ギャラリーの名前を使用して、ギャラリーで使用できるイメージに対してクエリを実行することができます。

出力例を次に示します。

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

リソースの更新

更新可能な対象については、いくつか制限があります。 次の項目を更新できます。

Azure Compute Gallery:

  • 説明

イメージ定義:

  • 推奨される vCPU:
  • 推奨されるメモリ
  • 説明
  • 有効期限の終了日

イメージ バージョン:

  • リージョンのレプリカ数
  • ターゲット リージョン
  • 最新バージョンからの除外
  • 有効期限の終了日

az sig update を使用してギャラリーの説明を更新します。

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

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

az sig image-version update を使用して、複製先のリージョンを追加するイメージ バージョンを更新します。 イメージが新しいリージョンに複製されるため、この変更には時間がかかります。

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

この例では、az sig image-version update を使用して、このイメージ バージョンが "最新" のイメージとして使用されないようにする方法を示します。

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

この例では、az sig image-version update を使用して、このイメージ バージョンを "最新" のイメージとして見なして含める方法を示します。

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

リソースを削除する

最初にイメージのバージョンを削除することによって、逆の順序でリソースを削除する必要があります。 すべてのイメージのバージョンを削除した後、イメージの定義を削除できます。 すべてのイメージの定義を削除した後、ギャラリーを削除できます。

コミュニティ共有ギャラリーを削除する前に、az sig share reset を使用してギャラリーの共有を公に停止する必要があります。

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

az sig image-definition delete を使用してイメージの定義を削除します。

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

az sig delete を使ってギャラリーを削除します。

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

コミュニティ ギャラリー

重要

Azure Compute Gallery – コミュニティ ギャラリーは現在プレビュー段階であり、Azure Compute Gallery - コミュニティ ギャラリーのプレビューの使用条件の対象となります。

コミュニティ ギャラリーを公開するには、Azure サブスクリプションでプレビュー機能を設定する必要があります。 コミュニティ ギャラリー イメージからの VM の作成は、すべての Azure ユーザーに開放されています。

独自のギャラリーを一覧表示し、コミュニティ ギャラリーのパブリック名を出力するには、次のようにします。

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

注意

エンド ユーザーとして、コミュニティ ギャラリーのパブリック名を取得するには、現在ポータルを使用する必要があります。 [仮想マシン]>[作成]>[Azure 仮想マシン]>[イメージ]>[すべてのイメージを表示]>[コミュニティ イメージ]>[Public gallery name] (パブリック ギャラリー名) に移動します。

az sig image-definition list-community を使用して、コミュニティ ギャラリーで使用可能なすべてのイメージ定義を一覧表示します。

この例では、"米国西部" の ContosoImage ギャラリー内のすべてのイメージと、VM、OS、OS の状態を作成するために必要な一意の ID を一覧表示します。

 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

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

直接共有ギャラリー

重要

Azure Compute Gallery – 直接共有ギャラリーは現在プレビュー段階であり、Azure Compute Gallery のプレビューの使用条件の対象となります。

プレビュー中にイメージを直接共有ギャラリーに公開するには、https://aka.ms/directsharedgallery-preview で登録する必要があります。 直接共有ギャラリーからの VM の作成は、すべての Azure ユーザーに開放されています。

プレビュー中は、プロパティ sharingProfile.permissions を Groups に設定して、新しいギャラリーを作成する必要があります。 CLI を使用してギャラリーを作成するときは、--permissions groups パラメーターを使用します。 既存のギャラリーを使用することはできません。プロパティは現在更新できません。

共有されているギャラリーの uniqueID を検索するには、az sig list-shared を使用します。 この例では、米国西部リージョンのギャラリーを見ています。

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

az sig image-definition list-shared を使用して、直接共有されているすべてのイメージ定義を一覧表示します。

この例では、米国西部のギャラリー内のすべてのイメージと、VM、OS、OS の状態を作成するために必要な一意の ID を一覧表示します。

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

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

次のステップ