DeleteSnapshot - 云服务器 ECS

调用DeleteSnapshot删除指定的快照。如果需要取消正在创建的快照，也可以调用该接口删除快照，即取消创建快照任务。

接口说明

调用该接口时，您需要注意：

如果指定的快照ID不存在，请求将被忽略。
如果快照已经被用于创建自定义镜像，将不能执行删除操作。您需要先删除已创建的自定义镜像（DeleteImage），才能继续删除快照。
如果快照已经被用于创建云盘，且未设置Force参数或Force=false时，不能直接删除快照。如果您确定要删除快照，请设置Force=true进行强制删除，快照被强制删除后对应的云盘将不能执行重新初始化。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	DeleteSnapshot	系统规定参数。取值：DeleteSnapshot。
SnapshotId	String	是	s-bp1c0doj0taqyzzl****	快照ID。
Force	Boolean	否	false	是否强制删除已经被用于创建云盘的快照。取值范围： true：强制删除。强制删除后该磁盘无法重新初始化。 false：不强制删除。默认值：false

返回数据


名称	类型	示例值	描述
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	请求ID。

示例

请求示例

https://ecs.aliyuncs.com/?Action=DeleteSnapshot
&SnapshotId=s-bp1c0doj0taqyzzl****
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DeleteSnapshotResponse>
     <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
</DeleteSnapshotResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}

错误码


HttpCode	错误码	错误信息	描述
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.	您当前的操作可能与其他人的操作产生了冲突，请稍后重试。
404	InvalidSnapshotId.NotFound	The specified snapshot is not found	指定的快照不存在。
500	InternalError	The request processing has failed due to some unknown error.	内部错误，请重试。

访问错误中心查看更多错误码。