调用DeleteSnapshot删除指定的快照。如果需要取消正在创建的快照,也可以调用该接口删除快照,即取消创建快照任务。
接口说明
调用该接口时,您需要注意:
- 如果指定的快照 ID 不存在,请求将被忽略。
- 如果快照已经被用于创建自定义镜像,将不能执行删除操作。您需要先删除已创建的自定义镜像( DeleteImage ),才能继续删除快照。
- 如果快照已经被用于创建云盘,且未设置
Force
参数或Force=false
时,不能直接删除快照。如果您确定要删除快照,请设置Force=true
进行强制删除,快照被强制删除后对应的云盘将不能执行重新初始化。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
SnapshotId | string | 是 | 快照 ID。 | s-bp1c0doj0taqyzzl**** |
Force | boolean | 否 | 是否强制删除已经被用于创建云盘的快照。取值范围:
默认值:false | false |
返回参数
示例
正常返回示例
JSON
格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
错误码
HTTP status code | 错误码 | 错误信息 | 描述 |
---|
HTTP status code | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | MissingParameter | The input parameter SnapshotId that is mandatory for processing this request is not supplied. | 参数 SnapshotId 不得为空。 |
403 | SnapshotCreatedImage | The snapshot has been used to create user defined image(s). | 如果快照已经被用于创建自定义镜像,将不能执行删除操作。您需要先删除已创建的自定义镜像(DeleteImage),才能继续删除快照。 |
403 | SnapshotCreatedDisk | The snapshot has been used to create disk(s). | 指定的快照已经用于创建云盘,当未设置 Force 参数或 Force 参数值为 false 时,不能直接删除快照。如果您确定要删除快照,请设置 Force 参数值为 true 进行强制删除,快照被强制删除后对应的云盘将不能执行重新初始化。 |
403 | Operation.Conflict | The operation may conflicts with others, please retry later. | 您当前的操作可能与其他人的操作产生了冲突,请稍后重试。 |
403 | InvalidOperation.RelatedSnapshotNotFinished | The related standard snapshot is not finished. | 当前快照有关联的快照未完成,请稍后重试。 |
403 | SnapshotCreatedDisk | The snapshot that you are trying to delete is in use by one or more disks. | 您当前试图删除的快照已被用于创建一个或者多个磁盘。 |
403 | InvalidOperation.DeleteSharedSnapshotUnsupported | The current snapshot shares authorization with other users. Please revoke the shared authorization through resource management first. | 当前快照被共享授权其他用户使用,请先使用资源管理撤销授权后再操作。 |
403 | InvalidOperation.ResourceManagedByCloudProduct | The current operation is not supported because the resource is managed by a cloud product. Please contact the relevant cloud product to confirm the reason. | 此次操作不支持因为资源被云产品托管。请联系对应的云产品确认原因。 |
404 | InvalidSnapshotId.NotFound | The specified snapshot is not found. | 指定的Snapshot不存在。 |
500 | InternalError | The request processing has failed due to some unknown error. | 内部错误,请重试。 |
访问错误中心查看更多错误码。