弃用镜像或恢复可用镜像 - 云服务器 ECS

如果镜像族系内最新版本的自定义镜像有缺陷需要使用较旧版本的镜像恢复业务，您可以将镜像族系内可用的最新自定义镜像设置为弃用即可实现。如果您需要使用镜像族系中已弃用版本的镜像业务，您可以将该自定义镜像恢复为可用。本文介绍如何弃用或恢复镜像族系中的镜像。

前提条件

您已经创建两个自定义镜像，并设置在同一个镜像族系内。具体操作，请参见设置镜像族系。

本示例中镜像族系为image-test，包含两个镜像image1和image2，其中image2为可用的最新自定义镜像。

弃用或可用状态的镜像有如下使用限制：

将镜像族系中最新可用的自定义镜像状态设置为弃用后，使用该镜像族系创建ECS实例时，默认使用除去该自定义镜像之外的最新可用的自定义镜像。

重要

如果镜像族系中只有唯一一个可用状态的自定义镜像，则弃用镜像后该镜像族系将无可用状态的自定义镜像用来创建实例，因此请谨慎操作。

登录ECS管理控制台。
在左侧导航栏，选择实例与镜像 > 镜像。
在页面左侧顶部，选择目标资源所在的资源组和地域。
弃用镜像族系image-test中的最新版本镜像image2。
1. （条件可选）在自定义镜像列表右上角打开。
2. 在镜像族系区域中，单击相应的镜像族系名称image-test。
3. 在镜像image2的操作列，选择 > 弃用镜像。
4. 确认弃用信息后，单击确定。
5. 查看镜像image2的状态列，显示为已弃用。
登录OpenAPI Explorer。
查找并调用DescribeImageFromFamily接口查询指定镜像族系内最新的镜像。
本示例中，查询镜像族系image-test内最新的镜像，API的请求参数说明如下：
- RegionId：镜像族系所在地域。
- ImageFamily：镜像族系名称。本示例中使用image-test。
返回值部分结果示例如下，得到可用的最新镜像名称为image1，说明镜像族系内的image2已弃用。

如果您需要使用镜像族系中已弃用的最新自定义镜像，需将该自定义镜像恢复可用，即可作为最新可用的自定义镜像使用。

登录ECS管理控制台。
在左侧导航栏，选择实例与镜像 > 镜像。
在页面左侧顶部，选择目标资源所在的资源组和地域。
恢复镜像族系image-test中的最新版本镜像image2。
1. （条件可选）在自定义镜像列表右上角打开。
2. 在镜像族系区域中，单击相应的镜像族系名称image-test。
3. 在已弃用状态的镜像image2的操作列，选择 > 恢复可用。
4. 确认恢复信息后，单击确定。
5. 查看镜像image2的状态列，显示为可用。
登录OpenAPI Explorer。
查找并调用DescribeImageFromFamily接口查询指定镜像族系内最新的镜像。
本示例中，查询镜像族系image-test内最新的镜像，API的请求参数说明如下：
- RegionId：镜像族系所在地域。
- ImageFamily：镜像族系名称。本示例中使用image-test。
返回值部分结果示例如下，得到可用的最新镜像名称为image2，说明镜像族系内的image2已恢复。