View a markdown version of this page

Cara mengambil atau menyalin objek berdasarkan metadata dengan pembacaan bersyarat - Amazon Simple Storage Service
API yang didukung

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 pada GETHEAD,, atau COPY permintaan untuk hanya mengembalikan objek berdasarkan metadatanya.

Saat Anda mengunggah objek, Amazon S3 membuat metadata yang dikendalikan sistem yang hanya dapat dimodifikasi oleh S3. Tag entitas (ETag) dan merupakan contoh Last-Modified 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 paling lambat.

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 dan mengembalikan objek hanya jika objek tersebut telah dimodifikasi sejak tanggal yang Anda berikan.

API yang didukung

Dukungan API S3 berikut menggunakan pembacaan bersyarat:

Anda dapat menggunakan header berikut untuk mengembalikan objek tergantung pada tag entitas (ETag) atau tanggal modifikasi terakhir. Untuk informasi selengkapnya tentang metadata objek seperti ETag dan Last-Modified, lihat. System-defined metadata objek

GetObject

  • If-Match— Kembalikan objek hanya jika ETag-nya 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-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, kesalahan yang dikembalikan, dan urutan S3 menangani beberapa header bersyarat dalam satu permintaan, lihat GetObject di Referensi API Layanan Penyimpanan Sederhana Amazon.

HeadObject

  • If-Match— Kembalikan objek hanya jika ETag-nya 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-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, kesalahan yang dikembalikan, dan urutan S3 menangani beberapa header bersyarat dalam satu permintaan, lihat HeadObject di Referensi API Layanan Penyimpanan Sederhana Amazon.

CopyObject

  • x-amz-copy-source-if-match— Menyalin objek sumber hanya jika ETag-nya 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-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-nya cocok dengan yang disediakan. If-Matchmengharapkan nilai ETag sebagai string.

  • If-None-Match— Menyalin objek hanya jika ETag-nya tidak cocok dengan yang disediakan. If-None-Matchmengharapkan karakter '*' (tanda bintang).

Untuk informasi selengkapnya tentang header ini, kesalahan yang dikembalikan, dan urutan S3 menangani beberapa header bersyarat dalam satu permintaan, lihat CopyObject di Referensi API Layanan Penyimpanan Sederhana Amazon.

Untuk informasi tentang menggunakan header bersyarat untuk mencegah penulisan ulang selama operasi penulisan, lihat. Cara mencegah penulisan objek dengan penulisan bersyarat