云服务器删除镜像-云服务器 API 2017-API 中心-腾讯云

说明: 
当前页面接口为旧版 API，未来可能停止维护，目前不展示在左侧导航。云服务器 API 3.0 版本接口定义更加规范，访问时延下降显著，建议使用 云服务器 API 3.0。
1. 接口描述
本接口（DeleteImages）用于删除一个或多个镜像。
接口请求域名：image.api.qcloud.com
当镜像状态为创建中和使用中时, 不允许删除。镜像状态可以通过 DescribeImages 获取。
每个地域最多只支持创建10个自定义镜像，删除镜像可以释放账户的配额。
当镜像正在被其它账户分享时，不允许删除。
2. 输入参数
以下请求参数列表仅列出了接口请求参数，其它参数可参考 公共请求参数。
参数名称
类型
是否必选
描述
Version
String
是
表示 API 版本号，主要用于标识请求的不同 API 版本。 
本接口第一版本可传：2017-03-12。
ImageIds.N
Array of Strings
是
镜像 ID 列表，镜像 ID 可以通过如下方式获取：
通过 DescribeImages 接口返回的ImageId获取。
通过 镜像控制台 获取。镜像 ID 必须满足下列限制：镜像 ID 对应的镜像状态必须为NORMAL。镜像 ID 对应的镜像没有共享给其它账户。
3. 输出参数
参数名称
类型
描述
RequestId
String
唯一请求 ID。每次请求都会返回一个唯一的 RequestId，当客户调用接口失败需要后台研发人员处理时需提供该 RequestId。
4. 错误码
以下错误码表仅列出了该接口的业务逻辑错误码，更多错误码详见 公共错误码。
错误码
描述
InvalidImageId.InShared
镜像处于共享中。
InvalidImageId.IncorrectState
镜像状态不合法。
InvalidImageId.NotFound
未找到该镜像。
InvalidImageId.Malformed
错误的镜像 ID 格式。
5. 示例
请求参数
https://image.api.qcloud.com/v2/index.php?Action=DeleteImages
&Version=2017-03-12
&ImageIds.0=img-o3ycss2p
&imageIds.1=img-kb1a392d
&<公共请求参数>
返回参数
{
    "Response": {
        "RequestID": "354f4ac3-8546-4516-8c8a-69e3ab73aa8a"
    }
}
﻿

参数名称	类型	是否必选	描述
Version	String	是	表示 API 版本号，主要用于标识请求的不同 API 版本。本接口第一版本可传：2017-03-12。
ImageIds.N	Array of Strings	是	镜像 ID 列表，镜像 ID 可以通过如下方式获取：通过 DescribeImages 接口返回的`ImageId`获取。通过镜像控制台获取。镜像 ID 必须满足下列限制：镜像 ID 对应的镜像状态必须为`NORMAL`。镜像 ID 对应的镜像没有共享给其它账户。

错误码	描述
InvalidImageId.InShared	镜像处于共享中。
InvalidImageId.IncorrectState	镜像状态不合法。
InvalidImageId.NotFound	未找到该镜像。
InvalidImageId.Malformed	错误的镜像 ID 格式。

删除镜像

本页目录：

1. 接口描述

2. 输入参数

3. 输出参数

4. 错误码

5. 示例