調用DeleteSnapshot刪除指定的快照。如果需要取消正在創建的快照，也可以調用該接口刪除快照，即取消創建快照任務。
接口說明
調用該接口時，您需要注意：
- 如果指定的快照 ID 不存在，請求將被忽略。
- 如果快照已經被用于創建自定義鏡像，將不能執行刪除操作。您需要先刪除已創建的自定義鏡像（ DeleteImage ），才能繼續刪除快照。
- 如果快照已經被用于創建云盤，且未設置
Force參數或Force=false時，不能直接刪除快照。如果您確定要刪除快照，請設置Force=true進行強制刪除，快照被強制刪除后對應的云盤將不能執行重新初始化。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| ecs:DeleteSnapshot | delete | *Snapshot acs:ecs:{#regionId}:{#accountId}:snapshot/{#snapshotId} |
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| SnapshotId | string | 是 | 快照 ID。 | s-bp1c0doj0taqyzzl**** |
| Force | boolean | 否 | 是否強制刪除已經被用于創建云盤的快照。取值范圍：
默認值：false | false |
返回參數
示例
正常返回示例
JSON格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}錯誤碼
| 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. | - |
| 500 | InternalError | The request processing has failed due to some unknown error. | 內部錯誤，請重試。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2024-12-04 | OpenAPI 描述信息更新、OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2024-10-16 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2023-11-08 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |