列出、更新和删除映像资源List, update, and delete image resources

可以使用 Azure CLI 管理共享映像库资源。You can manage your shared image gallery resources using the Azure CLI.

列出信息List information

使用 az sig list 获取有关可用映像库的位置、状态和其他信息。Get the location, status and other information about the available image galleries using az sig list.

az sig list -o table

使用 az sig image-definition list 列出库中的映像定义,包括有关 OS 类型和状态的信息。List the image definitions in a gallery, including information about OS type and status, using az sig image-definition list.

az sig image-definition list --resource-group myGalleryRG --gallery-name myGallery -o table

使用 az sig image-version list 列出库中的共享映像版本。List the shared image versions in a gallery, using az sig image-version list.

az sig image-version list --resource-group myGalleryRG --gallery-name myGallery --gallery-image-definition myImageDefinition -o table

使用 az sig image-version show 获取映像版本的 ID。Get the ID of an image version using az sig image-version show.

az sig image-version show \
   --resource-group myGalleryRG \
   --gallery-name myGallery \
   --gallery-image-definition myImageDefinition \
   --gallery-image-version 1.0.0 \
   --query "id"

更新资源Update resources

对于能够更新的内容,存在一些限制。There are some limitations on what can be updated. 以下项目可以更新:The following items can be updated:

共享映像库:Shared image gallery:

  • 说明Description

映像定义:Image definition:

  • 建议的 vCPU 数Recommended vCPUs
  • 建议的内存Recommended memory
  • 说明Description
  • 生命周期终结日期End of life date

映像版本:Image version:

  • 区域副本计数Regional replica count
  • 目标区域数Target regions
  • 从最新项中排除Exclusion from latest
  • 生命周期终结日期End of life date

如果打算添加副本区域,请勿删除源托管映像。If you plan on adding replica regions, do not delete the source managed image. 源托管映像是将映像版本复制到其他区域所需的。The source managed image is needed for replicating the image version to additional regions.

使用 az sig update 更新对库的说明。Update the description of a gallery using (az sig update.

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

使用 az sig image-definition update 更新对映像定义的说明。Update the description of an image definition using 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 更新要向其添加需复制的区域的映像版本。Update an image version to add a region to replicate to using az sig image-version update. 此更改需要一定的时间,因为需将映像复制到新区域。This change will take a while as the image gets replicated to the new region.

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=chinaeast

删除资源Delete resources

需按相反的顺序删除资源,先删除映像版本。You have to delete resources in reverse order, by deleting the image version first. 删除所有映像版本以后,即可删除映像定义。After you delete all of the image versions, you can delete the image definition. 删除所有映像定义以后,即可删除库。After you delete all image definitions, you can delete the gallery.

使用 az sig image-version delete 删除映像版本。Delete an image version using 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 删除映像定义。Delete an image definition using az sig image-definition delete.

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

使用 az sig delete 删除映像库。Delete an image gallery using az sig delete.

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