如果您不再需要某些自定义镜像，可以将其批量删除。自定义镜像被删除后，使用该镜像创建的轻量应用服务器将无法使用该镜像重置系统。
接口说明
如果自定义镜像处于共享中，需先取消共享镜像，然后删除自定义镜像。取消共享镜像后，您将无法通过云服务器 ECS 管理控制台或 ECS API 查询到该自定义镜像。如果您在云服务器 ECS 中还需要使用该镜像，建议您在删除自定义镜像前，先复制镜像。具体操作，请参见复制镜像。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
swas-open:DeleteCustomImages |
delete |
*CustomImage
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| RegionId |
string |
是 |
地域 ID。您可以调用 ListRegions 查询可用地域。 |
cn-hangzhou |
| ImageIds |
string |
是 |
轻量应用服务器的镜像 ID。取值可以由多个实例 ID 组成一个 JSON 数组，最多支持 15 个 ID，ID 之间用半角逗号（,）隔开。 |
["m-2zehv38jjmwva1ee****", "m-bp1hj0zhmheyq2kz****"] |
| ClientToken |
string |
否 |
保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符，且不能超过 64 个字符。更多信息，请参见如何保证幂等性。 |
123e4567-e89b-12d3-a456-426655440000 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| RequestId |
string |
请求 ID。 |
30637AD6-D977-4833-A54C-CC89483E**** |
示例
正常返回示例
JSON格式
{
"RequestId": "30637AD6-D977-4833-A54C-CC89483E****"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | CustomImageInShare | The custom image is in sharing,please unshare first then to retry. | 自定义镜像正在共享，请解除共享。 |
| 500 | InternalError | An error occurred while processing your request. | 内部错误，请重试。如果多次尝试失败，请提交工单。 |
| 404 | InvalidImageId.NotFound | The specified ImageId does not exist. | 指定的镜像不存在，请您检查镜像ID是否正确。 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。