文档中心

云服务器

请输入

快照

DeleteSnapshot - 删除快照

调用DeleteSnapshot接口删除快照。

注意事项

只有状态为“可用”或者“错误”的快照才可以删除，状态为“创建中”、“回滚中”的快照无法删除。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：DeleteSnapshot

要执行的操作，取值：DeleteSnapshot。

Version string 必选示例值：2020-04-01

API的版本，取值：2020-04-01。

ClientToken string 可选示例值：123e4567-e89b-12d3-a456-42665544****

用以保证请求幂等性。该字符串由您的客户端生成，用以保证不同请求之间的唯一性。ClientToken是一个大小写敏感、不超过64个ASCII字符的字符串。

SnapshotId string 必选示例值：snap-bp1s5fnvk4gn2****

待删除快照的ID。

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

GET /?Action=DeleteSnapshot&SnapshotId=snap-bp1s5fnvk4gn2****&Version=2020-04-01 HTTP/1.1​
Host: open.volcengineapi.com​
Region: cn-beijing​
ServiceName: storage_ebs​

返回示例

{​
        "ResponseMetadata": {​
                "RequestId": "20220308180931010225243139000DF***",​
                "Action": "DeleteSnapshot",​
                "Version": "2020-04-01",​
                "Service": "storage_ebs",​
                "Region": "cn-beijing"​
        },​
        "Result": {}​
}​

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	IncorrectSnapshotStatus	The specified snapshot status is invalid.	指定的快照状态不合法。
400	SnapshotCRRCopying	The specified snapshot is being replicated and cannot be deleted.	快照正在跨域复制中，不允许删除。
400	SnapshotExporting	The specified snapshot is being exported and cannot be deleted.	指定快照正在导出，无法删除。
400	SnapshotInCreatingVolume	The specified snapshot is being used to create a volume.	快照正被用于创建云盘中。
403	SnapshotForbiddenDelete	The specified snapshot cannot be deleted individually under the snapshot consistency group,please delete the snapshot consistency group first.	禁止单独删除快照一致性中的快照，请先删除快照一致性组。
403	SnapshotJobQuotaExceed	The number of snapshot task exceeds the limit.	快照任务数量超出限制。
403	SnapshotBindingImageForbiddenDelete	The snapshot is bound to a mirror and cannot be deleted.	该快照已绑定了镜像，禁止删除。
404	SnapshotNotFound	The specified snapshot does not exist.	指定的快照不存在。
500	InternalError	An internal error has occurred.	内部错误，请重试。如果多次尝试失败，请提交工单。

最近更新时间：2026.01.09 15:37:00

这个页面对您有帮助吗？

有用

无用