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. Tag entitas (ETag) dan Last-Modified merupakan contoh metadata yang dikendalikan sistem. ETag objek adalah string yang mewakili versi tertentu dari suatu objek. Last-Modified tanggal adalah metadata yang mewakili tanggal pembuatan objek atau tanggal modifikasi terakhir, mana yang terbaru.
Dengan pembacaan bersyarat, Anda dapat mengembalikan objek berdasarkan ETag atau Last-Modified tanggal objek. Anda dapat menentukan nilai ETag dengan permintaan Anda dan mengembalikan objek hanya jika nilai ETag cocok. Ini dapat memastikan Anda hanya mengembalikan atau menyalin versi tertentu dari suatu objek. Anda dapat menentukan Last-Modified nilai dengan permintaan baca Anda dan mengembalikan objek hanya jika objek tersebut telah dimodifikasi sejak tanggal yang Anda berikan.
API yang didukung
API S3 berikut mendukung 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 ETag dan, lihat. Last-Modified System-defined metadata objek
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 ETa-nya tidak cocok dengan yang disediakan. -
If-Unmodified-Since— Kembalikan objek hanya jika belum dimodifikasi sejak waktu yang ditentukan.
Untuk informasi selengkapnya tentang header ini, error yang ditampilkan, dan urutan S3 menangani beberapa header bersyarat dalam satu permintaan, lihat di Referensi API Amazon Simple Storage Service. GetObject
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 ETa-nya tidak cocok dengan yang disediakan. -
If-Unmodified-Since— Kembalikan objek hanya jika belum dimodifikasi sejak waktu yang ditentukan.
Untuk informasi selengkapnya tentang header ini, error yang ditampilkan, dan urutan S3 menangani beberapa header bersyarat dalam satu permintaan, lihat di Referensi API Amazon Simple Storage Service. HeadObject
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 ETa-nya tidak cocok dengan yang disediakan. -
x-amz-copy-source-if-unmodified-since— Menyalin objek sumber hanya jika belum dimodifikasi sejak waktu yang ditentukan. -
If-Match— Menyalin objek hanya jika ETag cocok dengan yang disediakan.If-Matchmengharapkan nilai ETag sebagai string. -
If-None-Match— Menyalin objek hanya jika ETag tidak cocok dengan yang disediakan.If-None-Matchmengharapkan karakter '*' (tanda bintang).
Untuk informasi selengkapnya tentang header ini, error yang ditampilkan, dan urutan S3 menangani beberapa header bersyarat dalam satu permintaan, lihat di Referensi API Amazon Simple Storage Service. CopyObject
