Cara melakukan penghapusan kondisional

Anda dapat menggunakan penghapusan bersyarat untuk mengevaluasi apakah objek Anda ada atau tidak berubah sebelum menghapusnya. Anda dapat melakukan penghapusan bersyarat menggunakan operasi DeleteObject atau DeleteObjects API di bucket tujuan umum dan direktori S3. Untuk memulai, saat membuat permintaan penghapusan bersyarat, Anda dapat menggunakan HTTP If-Match header dengan nilai prasyarat * untuk memeriksa apakah objek ada atau If-Match header dengan yang Anda sediakan ETag untuk memeriksa apakah objek telah dimodifikasi.

Anda dapat menerapkan penghapusan bersyarat pada tingkat bucket tujuan umum menggunakan bucket S3 atau kebijakan Manajemen Identitas dan Akses (IAM). Untuk informasi selengkapnya, lihat Menerapkan penghapusan bersyarat di bucket Amazon S3.

Cara memeriksa apakah objek Anda telah dimodifikasi sebelum menghapusnya

Dengan penghapusan bersyarat, Anda dapat melindungi aplikasi Anda dari penghapusan objek yang tidak disengaja. Anda dapat menggunakan HTTP If-Match header dengan ETag nilai untuk memeriksa apakah suatu objek telah dimodifikasi. Jika ETag nilai objek dalam bucket S3 tidak cocok dengan ETag yang Anda berikan selama operasi hapus, operasi gagal. Untuk menghapus beberapa objek secara kondisional menggunakan DeleteObjects operasi, Anda harus memberikan ETag nilai dalam ETag elemen objek di badan permintaan XML. Untuk informasi selengkapnya, lihat Menggunakan Content-MD5 dan ETag untuk memverifikasi objek yang diunggah.

If-MatchHeader dengan ETag nilai dievaluasi terhadap objek yang ada dalam bucket. Jika ada objek yang ada dengan nama kunci dan pencocokan yang samaETag, DeleteObject permintaan berhasil, dan mengembalikan 204 No content respons. Jika ETag tidak cocok, operasi hapus gagal dengan 412 Precondition Failed respons. Untuk menghapus beberapa objek secara kondisional menggunakan DeleteObjects operasi, Anda dapat memberikan ETag nilai dalam ETag elemen objek di badan permintaan XML. Jika permintaan berhasil, DeleteObjects operasi merespons dengan 200 OK a dan memberikan status setiap objek dalam badan respons. Jika prasyarat berhasil, respons untuk objek itu akan ditangkap dalam <Deleted> elemen badan respons. Jika prasyarat gagal maka respons untuk objek itu akan ditangkap dalam <Error> elemen badan respons.

Anda juga dapat menerima respons 409 Conflict kesalahan dalam kasus permintaan bersamaan jika PUT permintaan DELETE atau ke objek berhasil sebelum operasi penghapusan bersyarat pada objek tersebut selesai. Anda akan menerima 404 Not Found respons jika permintaan penghapusan bersamaan ke objek berhasil sebelum operasi penulisan bersyarat pada objek tersebut selesai, karena kunci objek tidak ada lagi.

Anda dapat menggunakan If-Match header dengan ETag nilai untuk API berikut:

aws s3api delete-object --bucket amzn-s3-demo-bucket --key dir-1/my_images.tar.bz2 --if-match "6805f2cfc46c0f04559748bb039d69al"       

aws s3api delete-objects --bucket amzn-s3-demo-bucket --delete '{"Objects":[{"Key":"my_images.tar.bz2", "ETag": "6805f2cfc46c0f04559748bb039d69al"}]}' 

Cara memeriksa apakah objek Anda ada sebelum menghapusnya

Anda dapat menggunakan If-Match header dengan * nilai untuk memeriksa apakah objek ada sebelum mencoba menghapusnya. Nilai * tersebut menandakan bahwa operasi hanya boleh dilanjutkan jika objek ada, terlepas dari apakah itu telah dimodifikasi atau tidak.

Penanda hapus adalah objek khusus dalam bucket tujuan umum S3 berversi yang menunjukkan bahwa objek telah dihapus. Mereka adalah placeholder yang membuat objek tampak dihapus sambil mempertahankan versi sebelumnya. Oleh karena itu, ketika Anda menggunakan If-Match:* dengan DeleteObject API, operasi hanya akan berhasil dengan a 204 No Content jika objek ada. Jika versi terbaru dari objek adalah penanda hapus, objek tidak ada dan DeleteObject API akan gagal dan mengembalikan 412 Precondition Failed respons. Untuk informasi selengkapnya tentang penanda hapus, lihat Bekerja dengan penanda hapus.

Untuk menghapus beberapa objek secara kondisional menggunakan DeleteObjects operasi, Anda dapat memberikan ETag elemen objek dalam badan permintaan XML. * Jika prasyarat berhasil, DeleteObjects operasi merespons dengan a 200 OK dan memberikan status setiap objek dalam badan respons. Jika prasyarat berhasil, respons untuk objek itu akan ditangkap dalam <Deleted> elemen badan respons. Jika prasyarat gagal maka respons untuk objek itu akan ditangkap dalam <Error> elemen badan respons. Jika objek tidak ada saat mengevaluasi salah satu prasyarat, S3 menolak permintaan dan mengembalikan respons Not Found kesalahan.

Anda dapat menggunakan If-Match header dengan * nilai untuk API berikut:

aws s3api delete-object --bucket amzn-s3-demo-bucket --key dir-1/my_images.tar.bz2 --if-match "*"

aws s3api delete-objects --bucket amzn-s3-demo-bucket --delete '{"Objects":[{"Key":"my_images.tar.bz2", "ETag": "*"}]}'