列出、更新和删除库资源
你可以使用 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
输出将包含与你共享的库的公共 name
和 uniqueID
。 可以使用库的名称来查询可以通过库使用的映像。
下面是示例输出:
[
{
"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