文档首页/ 智能数据湖 AI DataLake/ API参考/ 镜像快照管理/ 删除镜像快照 - DeleteV2TenantImageSnapshot
更新时间:2026-10-19 GMT+08:00
分享

删除镜像快照 - DeleteV2TenantImageSnapshot

功能介绍

删除指定的镜像快照。创建中的快照不允许删除。此接口为同步接口,无配套使用接口和特殊场景。

调用方法

请参见如何调用API。

URI

DELETE /v2/images/{image_id}/versions/{version_id}/image-snapshots/{image_snapshot_id}

表1 路径参数

参数

是否必选

参数类型

描述

image_id

是

String

参数解释:镜像ID。可通过查询自定义镜像列表获取镜像ID。

约束限制:不涉及。

取值范围:长度为32~36的英文字符、数字和中划线的组合。

默认取值:不涉及。

version_id

是

String

参数解释:镜像版本ID。可通过查询自定义镜像版本列表获取镜像版本ID。

约束限制:不涉及。

取值范围:长度为32~36的英文字符、数字和中划线的组合。

默认取值:不涉及。

image_snapshot_id

是

String

参数解释:镜像快照ID。可通过查询镜像快照列表获取镜像快照ID。

约束限制:不涉及。

取值范围:长度为32~36的英文字符、数字和中划线的组合。

默认取值:不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释:用户Token,通过调用获取IAM用户Token接口获取。

约束限制:不涉及。

取值范围:只能由英文字母、数字及特殊字符组成,长度不超过65534个字符。Token格式由IAM服务定义,具体字符集参见IAM服务相关文档。

默认取值:不涉及。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

image_snapshot_id

String

参数解释:被删除的镜像快照ID。

取值范围:长度为32~36的英文字符、数字和中划线的组合。

状态码:400

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:错误码。

取值范围:长度为8~36个字符。

error_msg

String

参数解释:错误描述。

取值范围:长度为2~512个字符。

solution_msg

String

参数解释:解决方案。

取值范围:长度为0~4096个字符。

状态码:401

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:错误码。

取值范围:长度为8~36个字符。

error_msg

String

参数解释:错误描述。

取值范围:长度为2~512个字符。

solution_msg

String

参数解释:解决方案。

取值范围:长度为0~4096个字符。

状态码:403

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:错误码。

取值范围:长度为8~36个字符。

error_msg

String

参数解释:错误描述。

取值范围:长度为2~512个字符。

solution_msg

String

参数解释:解决方案。

取值范围:长度为0~4096个字符。

状态码:404

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:错误码。

取值范围:长度为8~36个字符。

error_msg

String

参数解释:错误描述。

取值范围:长度为2~512个字符。

solution_msg

String

参数解释:解决方案。

取值范围:长度为0~4096个字符。

状态码:500

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:错误码。

取值范围:长度为8~36个字符。

error_msg

String

参数解释:错误描述。

取值范围:长度为2~512个字符。

solution_msg

String

参数解释:解决方案。

取值范围:长度为0~4096个字符。

请求示例

删除指定的镜像快照。

DELETE /v2/images/{image_id}/versions/{version_id}/image-snapshots/{image_snapshot_id}

响应示例

状态码:200

{
  "image_snapshot_id" : "9a0b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
}

状态码:400

{
  "error_code" : "AIDataLake.00010151",
  "error_msg" : "Parameter value is invalid.",
  "solution_msg" : "Please input valid parameter value."
}

状态码:401

{
  "error_code" : "APIGW.0301",
  "error_msg" : "Incorrect IAM authentication information: decrypt token fail.",
  "solution_msg" : "Check whether the IAM authentication information is correct."
}

状态码:403

{
  "error_code" : "AIDataLake.00010150",
  "error_msg" : "The operation is not allowed.",
  "solution_msg" : "Check whether the operation is allowed in the current status."
}

状态码:404

{
  "error_code" : "AIDataLake.00010401",
  "error_msg" : "Image snapshot not found, ID: 9a0b1c2d-3e4f-5a6b-8c7d-9e0f1a2b3c4d",
  "solution_msg" : "Please check if the image snapshot ID is correct."
}

状态码:500

{
  "error_code" : "AIDataLake.00011001",
  "error_msg" : "Internal error.",
  "solution_msg" : "Contact technical support or try again later."
}

状态码

状态码

描述

200

删除成功。

400

请求参数错误。

401

未授权。

403

禁止访问。

404

资源未找到。

500

内部服务器错误。

相关文档