镜像族系用于对一组相关镜像进行分类,可以帮助用户更好地管理和使用镜像。支持在创建自定义镜像或编辑镜像属性时,为自定义镜像设置镜像族系。本文介绍如何为自定义镜像设置镜像族系。
操作步骤
通过控制台设置镜像族系
您可以通过以下两种方式为自定义镜像设置镜像族系。
在创建自定义镜像过程中,为自定义镜像设置镜像族系。
具体操作,请参见使用实例创建自定义镜像或者使用快照创建自定义镜像。
在镜像创建完成后,通过编辑镜像属性,为自定义镜像设置镜像族系。
具体操作,请参见修改镜像的属性信息。
您可以输入自定义名称创建新的镜像族系,也可以选择已有的镜像族系。
说明镜像族系的名称长度为2~128个字符。镜像族系名称不能以特殊字符、数字、http://、https://开头,只可包含特殊字符中的"."、"_"、"-"和":"。
(可选)查看自定义镜像的镜像族系。
在镜像列表右上角打开。
在镜像族系区域,单击相应的镜像族系名称,查看镜像族系下的所有镜像。
通过API设置镜像族系
本操作将调用CreateImage接口,在创建自定义镜像时设置镜像族系。
登录OpenAPI开发者门户。
查找并调用CreateImage接口创建自定义镜像并设置镜像族系。
在本示例中,通过实例创建自定义镜像,设置名称为
hangzhou-image
的镜像族系。API的请求参数说明如下:RegionId:选择地域。例如,
cn-hangzhou
,即华东1(杭州)。InstanceId:实例ID。例如,
i-bp117mtgmllecpwl****
。ImageFamily:镜像族系名称。本示例中使用
hangzhou-image
。
创建成功后,您将得到自定义镜像的ID。
查找并调用DescribeImages接口查询上一步创建的镜像所属镜像族系。
通过镜像ID查询,API的请求参数说明如下:
RegionId:选择与上一步相同的地域。
ImageId:镜像ID,输入上一步中创建好的自定义镜像ID。
返回值的部分结果示例如下,镜像族系参数
ImageFamily
值为hangzhou-image
。
相关文档
设置镜像族系后,如果您需要修改镜像的镜像族系,可以通过修改镜像的属性信息或者调用API接口ModifyImageAttribute修改。
设置镜像族系后,您可以通过镜像族系创建ECS实例。具体操作,请参见通过镜像族系创建ECS实例。