全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
云服务器 ECS

DeleteImage

更新时间:2017-09-13 12:58:07

描述

删除指定的用户自定义镜像。镜像删除之后将不能再用于创建、重置ECS实例。

如果指定的镜像不存在,则请求将被忽略.

请求参数

名称 类型 是否必须 描述
Action String 系统规定参数,取值:DeleteImage
RegionId String 镜像所在的 Region ID。Region ID 的列表详见 地域列表
ImageId String 镜像 ID
Force String 可选值:true 和 false。默认值为 false。当设置为 true 时,删除镜像将不校验当前镜像是否保有其他实例。

返回参数

全是公共返回参数,详见公共返回参数

错误码

错误代码 描述 Http状态码 语义
ImageUsingByInstance The specified image has been used to create instances. 403 指定的镜像 ID 还存在保有实例,不能删除该镜像
ImageIsCreating The specified image is being created. 403 指定镜像正在创建中
ImageUseShared The specified image has been shared to others. 403 指定镜像已经共享
OperationDenied.ImageCopying The specified image is being copied. 403 镜像正在复制中
InvalidRegionId.NotFound The specified region does not exist. 404 无效的 RegionId 取值(实际情况也可能是该用户无权使用此 Region)。RegionId 的列表详见 地域列表

示例

请求示例

  1. https://ecs.aliyuncs.com/?Action=DeleteImage
  2. &RegionId=cn-hangzhou
  3. &ImageId=m-63DFD5FB2
  4. &<公共请求参数>

返回示例

XML格式

  1. <DeleteImageResponse>
  2. <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
  3. </DeleteImageResponse>

JSON格式

  1. {
  2. "RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
  3. }
本文导读目录