列出、更新和删除库资源

你可以使用 Azure CLI 或 Azure PowerShell 管理你的 Azure Compute Gallery(先前称为“共享映像库”)资源。

列出与你共享的库

列出与你的订阅共享的库。

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

列出与你的租户共享的库。

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

输出将包含与你共享的库的公共 nameuniqueID。 可以使用库的名称来查询可以通过库使用的映像。

下面是示例输出:

[
  {
    "location": "chinanorth",
    "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=chinanorth

本示例说明如何使用 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