自定义镜像可以被设置为弃用，也可以恢复可用。通过将镜像状态设置为弃用，可以实现镜像族系内可用的自定义镜像回滚；通过将自定义镜像恢复可用，可以恢复镜像族系的最新自定义镜像。

前提条件

您已经创建两个自定义镜像，并设置在同一个镜像族系内，详情请参见设置镜像族系。本示例中镜像族系为image-test，包含两个镜像image1和image2，其中image2为可用的最新自定义镜像。

背景信息

无论自定义镜像是否设置了镜像族系，镜像的状态都可以改变。可用状态的镜像可以设置为弃用，而弃用状态的镜像也可以恢复可用。状态不同的镜像所能执行的操作也不同，具体请参见：
  • 已经共享的自定义镜像，需要先取消共享才能将状态修改为弃用。
  • 弃用状态的自定义镜像，可以直接创建实例或更换系统盘，但不能共享镜像或复制镜像。
  • 通过将镜像族系中最新可用的自定义镜像状态设置为弃用，可以实现镜像回滚。在使用该镜像族系创建ECS实例时，将不会使用弃用状态的最新自定义镜像，而是使用除去该自定义镜像之外的最新可用自定义镜像。
    注意 如果您需要回滚镜像族系中的自定义镜像，可以将最新可用的自定义镜像设置为弃用状态，但如果该镜像为镜像族系中唯一一个可用状态的自定义镜像，则弃用镜像以后该镜像族系将无可用状态自定义镜像用来创建实例，因此请谨慎操作。
  • 如果您需要使用镜像族系中已弃用的最新自定义镜像，将该自定义镜像恢复可用，即可作为最新可用的自定义镜像使用。

弃用镜像族系内的镜像实现镜像回滚

  1. 登录ECS管理控制台。
  2. 在左侧导航栏，选择实例与镜像 > 镜像。
  3. 在顶部菜单栏左上角处，选择地域。
  4. 弃用镜像族系image-test中的最新版本镜像image2。
    1. 在自定义镜像页签的镜像族系区域中，通过搜索栏精确搜索image-test。
    2. 在镜像image2的操作列，单击更多操作图标，并单击弃用镜像。
    3. 查看镜像image2的状态栏，显示为弃用。
  5. 登录OpenAPI开发者门户。
  6. 查找并调用DescribeImageFromFamily接口查询指定镜像族系内最新的镜像。
    本示例中，查询镜像族系image-test内最新的镜像，API的请求参数说明如下：
    • RegionId：镜像族系所在地域。
    • ImageFamily：镜像族系名称。本示例中使用image-test。
    返回值部分结果示例如下，得到可用的最新镜像名称为image1，说明实现了镜像族系内镜像回滚。if1

恢复镜像族系内的镜像

  1. 登录ECS管理控制台。
  2. 在左侧导航栏，选择实例与镜像 > 镜像。
  3. 在顶部菜单栏左上角处，选择地域。
  4. 在自定义镜像页签的镜像族系区域中，通过搜索栏精确搜索image-test。
  5. 在弃用状态的镜像image2的操作列，单击更多操作图标，并单击恢复可用。
  6. 查看镜像image2的状态栏，显示为可用。
    此时镜像image2已恢复为可用的最新版本的镜像。您可以调用DescribeImageFromFamily接口查询定镜像族系内最新可用的自定义镜像。
  7. 查找并调用DescribeImageFromFamily接口查询指定镜像族系内最新的镜像。
    本示例中，查询镜像族系image-test内最新的镜像，API的请求参数说明如下：
    • RegionId：镜像族系所在地域。
    • ImageFamily：镜像族系名称。本示例中使用image-test。
    返回值部分结果示例如下，得到可用的最新镜像名称为image2。image2