文档

设置镜像族系

更新时间:

镜像族系用于对一组相关镜像进行分类,可以帮助用户更好地管理和使用镜像。支持在创建自定义镜像或编辑镜像属性时,为自定义镜像设置镜像族系。本文介绍如何为自定义镜像设置镜像族系。

操作步骤

通过控制台设置镜像族系

  1. 您可以通过以下两种方式为自定义镜像设置镜像族系。

    您可以输入自定义名称创建新的镜像族系,也可以选择已有的镜像族系。

    说明

    镜像族系的名称长度为2~128个字符。镜像族系名称不能以特殊字符、数字、http://、https://开头,只可包含特殊字符中的"."、"_"、"-"和":"。

  2. (可选)查看自定义镜像的镜像族系。

    1. 在镜像列表右上角打开image.png

    2. 镜像族系区域,单击相应的镜像族系名称,查看镜像族系下的所有镜像。

      image.png

通过API设置镜像族系

本操作将调用CreateImage接口,在创建自定义镜像时设置镜像族系。

  1. 登录OpenAPI开发者门户

  2. 查找并调用CreateImage接口创建自定义镜像并设置镜像族系。

    在本示例中,通过实例创建自定义镜像,设置名称为hangzhou-image的镜像族系。API的请求参数说明如下:

    • RegionId:选择地域。例如,cn-hangzhou,即华东1(杭州)。

    • InstanceId:实例ID。例如,i-bp117mtgmllecpwl****

    • ImageFamily:镜像族系名称。本示例中使用hangzhou-image

    创建成功后,您将得到自定义镜像的ID。if3

  3. 查找并调用DescribeImages接口查询上一步创建的镜像所属镜像族系。

    通过镜像ID查询,API的请求参数说明如下:

    • RegionId:选择与上一步相同的地域。

    • ImageId:镜像ID,输入上一步中创建好的自定义镜像ID。

    返回值的部分结果示例如下,镜像族系参数ImageFamily值为hangzhou-imageif4

相关文档