刪除指定的快照。如果需要取消正在建立的快照，也可以調用該介面刪除快照，即取消建立快照任務。

描述

調用該介面時，您需要注意：

  • 如果指定的快照 ID 不存在，請求將被忽略。

  • 如果快照已經被用於建立自訂鏡像，則快照不能被刪除。您需要先刪除已建立的自訂鏡像（DeleteImage），才能繼續刪除快照。

請求參數

名稱 類型 是否必需 描述
Action String 是 系統規定參數。取值：DeleteSnapshot
SnapshotId String 是 快照 ID。

返回參數

全是公共返回參數。參閱 公共參數。

樣本

請求樣本 
https://ecs.aliyuncs.com/?Action=DeleteSnapshot
&SnapshotId=s-923FE2BF0
&<公共請求參數>
返回樣本

XML 格式

<DeleteSnapshotResponse>
     <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
</DeleteSnapshotResponse>
JSON 格式 
{
    "RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼，請訪問 API 錯誤中心。

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
MissingParameter The input parameter SnapshotId that is mandatory for processing this request is not supplied. 400 您必須指定參數 SnapshotId。
SnapshotCreatedDisk The snapshot has been used to create disk(s). 403 指定快照已經建立了磁碟。
SnapshotCreatedImage The snapshot has been used to create user defined image(s). 403 指定快照已經被用於建立自訂鏡像。您需要先刪除已建立的自訂鏡像。