Menghapus Arsip (DELETE archive)

Deskripsi

Operasi ini menghapus arsip dari vault. Anda dapat menghapus satu arsip sekaligus dari vault. Untuk menghapus arsip, Anda harus memberikan ID arsip dalam permintaan hapus. Anda bisa mendapatkan ID arsip dengan mengunduh inventaris vault untuk vault yang berisi arsip. Untuk informasi selengkapnya tentang mengunduh inventaris vault, lihat Mengunduh Inventaris Vault di Amazon S3 Glacier.

Setelah menghapus arsip, Anda mungkin masih dapat membuat permintaan yang sukses untuk memulai tugas guna mengambil arsip yang dihapus, tetapi tugas pengambilan arsip akan gagal.

Pengambilan arsip yang sedang berlangsung untuk ID arsip ketika Anda menghapus arsip mungkin atau mungkin tidak berhasil menurut skenario berikut:

• Jika tugas pengambilan arsip secara aktif menyiapkan data untuk diunduh saat Amazon S3 Glacier (S3 Glacier) menerima permintaan hapus arsip, operasi pengambilan arsip mungkin gagal.

• Jika tugas pengambilan arsip berhasil menyiapkan arsip untuk diunduh saat S3 Glacier menerima permintaan hapus arsip, Anda akan dapat mengunduh hasilnya.

Untuk informasi selengkapnya tentang pengambilan arsip, lihat Mengunduh Arsip di S3 Glacier.

Operasi ini bersifat idempoten. Mencoba untuk menghapus arsip yang sudah dihapus tidak menyebabkan kesalahan.

Permintaan

Untuk menghapus arsip, Anda mengirim permintaan DELETE ke URI sumber daya arsip.

Sintaksis

DELETE /AccountId/vaults/VaultName/archives/ArchiveID HTTP/1.1
Host: glacier.Region.amazonaws.com
x-amz-Date: Date
Authorization: SignatureValue
x-amz-glacier-version: 2012-06-01

catatan

Nilai AccountId adalah ID Akun AWS dari akun yang memiliki vault. Anda dapat menentukan ID Akun AWS atau secara opsional satu '-' (tanda hubung), dalam hal ini, Amazon S3 Glacier menggunakan ID Akun AWS yang terkait dengan kredensial yang digunakan untuk menandatangani permintaan. Jika Anda menggunakan ID akun, jangan sertakan tanda hubung ('-') di ID.

Parameter Permintaan

Operasi ini tidak menggunakan parameter permintaan.

Header Permintaan

Operasi ini hanya menggunakan header permintaan yang umum untuk semua operasi. Untuk informasi selengkapnya tentang header permintaan umum, lihat Header Permintaan Umum.

Isi Permintaan

Operasi ini tidak memiliki isi permintaan.

Respons

Sintaksis

HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date

Header Respons

Operasi ini hanya menggunakan header respons yang umum untuk sebagian besar respons. Untuk informasi tentang header permintaan umum, lihat Header Respons Umum.

Isi Respons

Operasi ini tidak mengembalikan isi respons.

Kesalahan

Untuk informasi tentang pengecualian dan pesan kesalahan Amazon S3 Glacier, lihat Respons Kesalahan.

Contoh

Contoh berikut menunjukkan cara menghapus arsip dari vault bernama examplevault.

Contoh Permintaan

ID dari arsip yang akan dihapus ditentukan sebagai subsumber daya dari archives.

DELETE /-/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2	

Contoh Respons

Jika permintaan berhasil, S3 Glacier merespons dengan 204 No Content untuk menunjukkan bahwa arsip dihapus.

HTTP/1.1 204 No Content
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT

Bagian Terkait

• Memulai Unggahan Multipart (POST multipart-uploads)

• Mengunggah Arsip (POST archive)

• Identity and Access Management untuk Amazon S3 Glacier