本文分别介绍如何通过ECS控制台或调用API设置镜像族系。
背景信息
镜像族系不能单独创建,需要在创建自定义镜像时设置镜像族系。如果设置的镜像族系不存在,将会自动生成镜像族系。如果设置的镜像族系已存在,则自定义镜像将选择该镜像族系。
通过控制台设置镜像族系
- 登录ECS管理控制台。
- 在顶部菜单栏左上角处,选择地域。
- 通过以下任意一种方式创建自定义镜像。
在创建自定义镜像过程中,需要在创建自定义镜像对话框内,为自定义镜像设置镜像族系。
您可以输入自定义名称创建新的镜像族系,也可以选择已有的镜像族系。
说明 镜像族系的名称长度为2~128个英文或中文字符。必须以大小字母或中文开头,不能以http://、https://、acs:和aliyun开头。可以包含数字、半角冒号(:)、下划线(_)或者连字符(-)。

- 在左侧导航栏中,单击,查看创建的自定义镜像以及对应的镜像族系信息。
在
镜像族系区域,搜索镜像族系或单击相应的镜像族系名称,查找对应的镜像信息。

通过API设置镜像族系
本节将调用CreateImage在创建自定义镜像时设置镜像族系,接口详情请参见CreateImage。
- 登录OpenAPI Explorer。
- 查找并调用CreateImage接口创建自定义镜像并设置镜像族系。
在本示例中,通过实例创建自定义镜像,设置名为
hangzhou-image
的镜像族系。API的请求参数说明如下:
- RegionId:选择地域。例如,
cn-hangzhou
,即华东1(杭州)。
- InstanceId:实例ID。例如,
i-bp117mtgmllecpwl****
。
- ImageFamily:镜像族系名称。本示例中使用
hangzhou-image
。
创建成功后得到自定义镜像ID。

- 查找并调用DescribeImages接口查询上一步创建的镜像所属镜像族系。接口详情请参见DescribeImages。
通过镜像ID查询,API的请求参数说明如下:
- RegionId:选择与上一步相同的地域。
- ImageId:镜像ID,输入上一步中创建好的自定义镜像ID。
返回值的部分结果示例如下,镜像族系参数
ImageFamily
值为
hangzhou-image
。

后续步骤
当您需要修改镜像的镜像族系时,可以通过调用API ModifyImageAttribute实现,详情请参见ModifyImageAttribute。