Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Cara mengambil atau menyalin objek berdasarkan metadata dengan pembacaan bersyarat
Dengan pembacaan bersyarat, Anda dapat menambahkan header tambahan ke permintaan baca Anda untuk menambahkan prasyarat ke operasi S3 Anda. Jika prasyarat ini tidak terpenuhi, permintaan baca akan gagal.
Anda dapat menggunakan pembacaan bersyarat padaGET,HEAD, atau COPY permintaan untuk hanya mengembalikan objek berdasarkan metadatanya.
Saat Anda mengunggah objek, Amazon S3 membuat metadata yang dikontrol sistem yang hanya dapat dimodifikasi oleh S3. Entity tags (ETags) dan Last-Modified adalah contoh metadata yang dikendalikan sistem. Objek ETag adalah string yang mewakili versi tertentu dari suatu objek. Tanggal Modifikasi Terakhir adalah metadata yang mewakili tanggal pembuatan objek atau tanggal modifikasi terakhir, mana yang terbaru.
Dengan pembacaan bersyarat, Anda dapat mengembalikan objek berdasarkan tanggal objek ETag atau Terakhir Modifikasi. Anda dapat menentukan ETag nilai dengan permintaan Anda dan mengembalikan objek hanya jika ETag nilainya cocok. Ini dapat memastikan Anda hanya mengembalikan atau menyalin versi tertentu dari suatu objek. Anda dapat menentukan nilai Modifikasi Terakhir dengan permintaan baca Anda dan mengembalikan objek hanya jika objek tersebut telah dimodifikasi sejak tanggal yang Anda berikan.
Didukung APIs
APIsDukungan S3 berikut menggunakan pembacaan bersyarat:
Anda dapat menggunakan header berikut untuk mengembalikan objek yang bergantung pada tag entitas (ETag) atau tanggal modifikasi terakhir. Untuk informasi selengkapnya tentang metadata objek seperti ETags dan Last-Modified, lihat. Metadata objek yang ditentukan sistem
GetObject
-
If-Match— Kembalikan objek hanya jika ETag cocok dengan yang disediakan. -
If-Modified-Since— Kembalikan objek hanya jika telah dimodifikasi sejak waktu yang ditentukan. -
If-None-Match— Kembalikan objek hanya jika ETag tidak cocok dengan yang disediakan. -
If-Unmodified-Since— Kembalikan objek hanya jika belum dimodifikasi sejak waktu yang ditentukan.
Untuk informasi selengkapnya tentang header ini, kesalahan yang ditampilkan, dan urutan S3 menangani beberapa header bersyarat dalam satu permintaan, lihat GetObjectdi API Referensi Layanan Penyimpanan Sederhana Amazon.
HeadObject
-
If-Match— Kembalikan objek hanya jika ETag cocok dengan yang disediakan. -
If-Modified-Since— Kembalikan objek hanya jika telah dimodifikasi sejak waktu yang ditentukan. -
If-None-Match— Kembalikan objek hanya jika ETag tidak cocok dengan yang disediakan. -
If-Unmodified-Since— Kembalikan objek hanya jika belum dimodifikasi sejak waktu yang ditentukan.
Untuk informasi selengkapnya tentang header ini, kesalahan yang ditampilkan, dan urutan S3 menangani beberapa header bersyarat dalam satu permintaan, lihat HeadObjectdi API Referensi Layanan Penyimpanan Sederhana Amazon.
CopyObject
-
x-amz-copy-source-if-match— Menyalin objek sumber hanya jika ETag cocok dengan yang disediakan. -
x-amz-copy-source-if-modified-since— Menyalin objek sumber hanya jika telah dimodifikasi sejak waktu yang ditentukan. -
x-amz-copy-source-if-none-match— Menyalin objek sumber hanya jika ETag tidak cocok dengan yang disediakan. -
x-amz-copy-source-if-unmodified-since— Menyalin objek sumber hanya jika belum dimodifikasi sejak waktu yang ditentukan.
Untuk informasi selengkapnya tentang header ini, kesalahan yang ditampilkan, dan urutan S3 menangani beberapa header bersyarat dalam satu permintaan, lihat CopyObjectdi API Referensi Layanan Penyimpanan Sederhana Amazon.
