指定されたスナップショットを削除します。 あるいは、スナップショット作成タスクを取り消すこともできます。

説明

このインターフェイスを呼び出すときは、次の点を考慮してください。

  • 指定された SnapshotId が存在しない場合、要求は無視されます。

  • カスタムイメージ(CreateImage)の作成に使用されているスナップショットは削除できませんが、DeleteSnapshot アクションを再試行する前に適切なカスタムイメージ (DeleteImage) を削除できます。

リクエストパラメータ

名前 必須かどうか 説明
Action String はい このインタフェースの名前。 値:DeleteSnapshot。
SnapshotId String はい スナップショット ID。

リターンパラメータ

すべて共通のパラメータです。共通パラメータを参照してください。

リクエスト例
  1. https://ecs.aliyuncs.com/?Action=DeleteSnapshot&SnapshotId=s-923FE2BF0&<Common request parameters>
レスポンス例

XML 形式

  1. <DeleteSnapshotResponse> <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId></DeleteSnapshotResponse>
JSON 形式
  1. { 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 指定されたスナップショットは、カスタムイメージの作成に使用されています。 最初に作成されたカスタムミラーを削除する必要があります。