All Products
Search
Document Center

:DeleteSnapshot

Last Updated:May 22, 2026

Anda dapat memanggil operasi ini untuk menghapus Snapshot. Jika Anda memanggil operasi ini untuk menghapus Snapshot yang sedang dalam proses pembuatan, tugas pembuatan Snapshot tersebut akan dibatalkan.

Description

Saat memanggil operasi ini, perhatikan hal-hal berikut:

  • Jika ID Snapshot yang ditentukan tidak ada, permintaan akan diabaikan.
  • Snapshot yang telah digunakan untuk membuat custom image tidak dapat dihapus. Snapshot tersebut hanya dapat dihapus setelah custom image yang dibuat dari Snapshot tersebut dihapus (DeleteImage).
  • Snapshot yang telah digunakan untuk membuat disk tidak dapat dihapus. Jika Anda tetap ingin menghapus Snapshot tersebut, atur parameter Force ke true untuk memaksa penghapusan Snapshot. Disk yang dibuat dari Snapshot tersebut tidak dapat diinisialisasi ulang setelah Snapshot dihapus secara paksa.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kemudahan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi ini untuk berbagai SDK.

Request parameters

ParameterTypeRequiredExampleDescription
ActionStringYesDeleteSnapshot

Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DeleteSnapshot.

SnapshotIdStringYess-bp1c0doj0taqyzzl****

ID Snapshot.

ForceBooleanNofalse

Menentukan apakah akan memaksa penghapusan Snapshot yang telah digunakan untuk membuat disk. Nilai yang valid:

  • true: memaksa penghapusan Snapshot. Setelah Snapshot dihapus secara paksa, disk yang dibuat dari Snapshot tersebut tidak dapat diinisialisasi ulang.
  • false: tidak memaksa penghapusan Snapshot.

Nilai default: false

Response parameters

ParameterTypeExampleDescription
RequestIdString473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

ID permintaan.

Examples

Contoh permintaan

https://ecs.aliyuncs.com/?Action=DeleteSnapshot
&SnapshotId=s-bp1c0doj0taqyzzl****
&<Common request parameters>

Contoh respons sukses

XML format

<DeleteSnapshotResponse>
       <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
</DeleteSnapshotResponse>

JSON format

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

Error codes

HTTP status codeError codeError messageDescription
403SnapshotCreatedImageThe snapshot has been used to create user defined image(s).Pesan kesalahan yang dikembalikan karena Snapshot telah digunakan untuk membuat custom image dan tidak dapat dihapus. Snapshot hanya dapat dihapus setelah custom image yang dibuat dari Snapshot tersebut dihapus (DeleteImage).
403SnapshotCreatedDiskThe snapshot has been used to create disk(s).Pesan kesalahan yang dikembalikan karena Snapshot telah digunakan untuk membuat disk dan tidak dapat dihapus. Jika Anda tetap ingin menghapus Snapshot tersebut, atur parameter Force ke true untuk memaksa penghapusan Snapshot. Disk yang dibuat dari Snapshot tersebut tidak dapat diinisialisasi ulang setelah Snapshot dihapus secara paksa.
400MissingParameterThe input parameter SnapshotId that is mandatory for processing this request is not supplied.Pesan kesalahan yang dikembalikan karena parameter SnapshotId yang wajib tidak ditentukan.
500InternalErrorThe request processing has failed due to some unknown error.Pesan kesalahan yang dikembalikan karena terjadi kesalahan internal. Coba lagi nanti.
404InvalidSnapshotId.NotFoundThe specified snapshot is not foundPesan kesalahan yang dikembalikan karena parameter SnapshotId yang ditentukan tidak ada.
403Operation.ConflictThe operation may conflicts with others, please retry later.Pesan kesalahan yang dikembalikan karena operasi bertabrakan dengan operasi lain. Coba lagi nanti.

Untuk daftar kode kesalahan, kunjungi API Error Center.