DeleteSnapshot - 刪除快照 - Elastic Compute Service

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

介面說明

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

如果指定的快照 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	否	是否強制移除已經被用於建立雲端硬碟的快照。取值範圍： true：強制移除。強制移除後該磁碟無法重新初始化。 false：不強制移除。預設值：false	false

返回參數

名稱	類型	描述	樣本值
	object
RequestId	string	請求 ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

樣本

正常返回樣本

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

異常返回樣本

JSON格式

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

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	MissingParameter	The input parameter SnapshotId that is mandatory for processing this request is not supplied.	參數 SnapshotId 不得為空白。
400	IncorrectDiskStatus.CreatingSnapshot	A previous snapshot creation is in process.	當前磁碟有建立中的快照，請您等待建立完成再試。
500	InternalError	The request processing has failed due to some unknown error.
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	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.	此次操作不支援因為資源被雲產品託管。請聯絡對應的雲產品確認原因。
403	InvalidOperation.SnapshotIsLocked	The current operation is not supported because the snapshot is locked. Please wait for the lock to expire before retrying.	當前操作不支援，因為快照已被鎖定。請等待鎖定到期後再重試。
404	InvalidSnapshotId.NotFound	The specified snapshot is not found.	指定的Snapshot不存在。

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。