本文分别介绍如何通过ECS控制台或调用API设置镜像族系。

前提条件

您已经创建ECS实例或已经创建了系统盘快照，具体操作请参见创建方式导航或创建一个云盘快照。

背景信息

镜像族系不能单独创建，需要在创建自定义镜像时设置镜像族系。如果设置的镜像族系不存在，将会自动生成镜像族系。如果设置的镜像族系已存在，则自定义镜像将选择该镜像族系。

通过控制台设置镜像族系

  1. 登录ECS管理控制台。
  2. 在顶部菜单栏左上角处，选择地域。
  3. 通过以下任意一种方式创建自定义镜像。

    在创建自定义镜像过程中，需要在创建自定义镜像对话框内，为自定义镜像设置镜像族系。

    您可以输入自定义名称创建新的镜像族系，也可以选择已有的镜像族系。
    说明 镜像族系的名称长度为2~128个英文或中文字符。必须以大小字母或中文开头，不能以http://、https://、acs:和aliyun开头。可以包含数字、半角冒号（:）、下划线（_）或者连字符（-）。
    site image family
  4. 在左侧导航栏中，单击实例与镜像 > 镜像，查看创建的自定义镜像以及对应的镜像族系信息。
    在镜像族系区域，搜索镜像族系或单击相应的镜像族系名称，查找对应的镜像信息。image family list

通过API设置镜像族系

本节将调用CreateImage在创建自定义镜像时设置镜像族系，接口详情请参见CreateImage。

  1. 登录OpenAPI开发者门户。
  2. 查找并调用CreateImage接口创建自定义镜像并设置镜像族系。
    在本示例中，通过实例创建自定义镜像，设置名为hangzhou-image的镜像族系。API的请求参数说明如下：
    • RegionId：选择地域。例如，cn-hangzhou，即华东1（杭州）。
    • InstanceId：实例ID。例如，i-bp117mtgmllecpwl****。
    • ImageFamily：镜像族系名称。本示例中使用hangzhou-image。
    创建成功后得到自定义镜像ID。if3
  3. 查找并调用DescribeImages接口查询上一步创建的镜像所属镜像族系。接口详情请参见DescribeImages。
    通过镜像ID查询，API的请求参数说明如下：
    • RegionId：选择与上一步相同的地域。
    • ImageId：镜像ID，输入上一步中创建好的自定义镜像ID。
    返回值的部分结果示例如下，镜像族系参数ImageFamily值为hangzhou-image。if4

后续步骤

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