Bekerja dengan metadata objek

Amazon S3 menyediakan beberapa cara untuk melampirkan metadata ke objek Anda. Anotasi memungkinkan Anda melampirkan muatan data kaya hingga 1 MB ke objek menggunakan operasi API khusus. Tag objek adalah pasangan nilai kunci untuk mengkategorikan dan mengendalikan akses ke objek. Anda juga dapat menyetel metadata yang ditentukan pengguna pada waktu upload, dan Amazon S3 mempertahankan metadata yang ditentukan sistem secara otomatis. Untuk informasi selengkapnya, lihat Metadata objek kustom, Menganotasi objek Anda, Menandai objek Anda, User-defined metadata, dan System-defined metadata objek.

Saat membuat objek, Anda menentukan kunci objek (atau nama kunci), yang secara unik mengidentifikasi objek dalam bucket Amazon S3. Untuk informasi selengkapnya, lihat Menamai objek Amazon S3. Anda juga dapat mengatur metadata yang ditentukan pengguna di Amazon S3 pada saat Anda mengunggah objek.

Setelah mengunggah objek, Anda tidak dapat mengubah metadata yang ditentukan pengguna ini. Satu-satunya cara untuk memodifikasi metadata ini adalah dengan membuat salinan objek dan mengatur metadata. Untuk informasi selengkapnya tentang mengedit metadata menggunakan konsol Amazon S3, lihat. Mengedit metadata objek di konsol Amazon S3

Metadata objek kustom

Metadata objek kustom adalah metadata yang Anda kontrol. Anda dapat menggunakan metadata objek kustom untuk menyimpan informasi tentang objek Anda yang berarti bagi aplikasi Anda. Amazon S3 mendukung tiga jenis metadata objek kustom: anotasi, tag objek, dan metadata yang ditentukan pengguna.

Anotasi

Anotasi diberi nama muatan data yang dapat Anda lampirkan ke objek Amazon S3 apa pun setelah diunggah. Setiap anotasi dapat menyimpan hingga 1 MB UTF-8 teks, seperti AI-generated output, hasil klasifikasi, atau catatan pemrosesan. Anda dapat membuat, mengambil, membuat daftar, dan menghapus anotasi tanpa memodifikasi objek itu sendiri. Untuk informasi selengkapnya, lihat Menganotasi objek Anda.

Tanda objek

Tag objek adalah pasangan nilai kunci yang dapat Anda gunakan untuk mengkategorikan, mengatur, dan mengontrol akses ke objek Anda. Setiap objek dapat memiliki hingga 10 tag. Anda dapat menggunakan tag dalam kebijakan IAM dan bucket, aturan Siklus Hidup S3, dan laporan alokasi biaya. Untuk informasi selengkapnya, lihat Menandai objek Anda.

User-defined metadata

Saat mengunggah objek, Anda juga dapat menetapkan metadata pada objek tersebut. Anda memberikan informasi opsional ini sebagai pasangan nama-nilai (nilai-kunci) saat Anda mengirimkan permintaan PUT atau POST untuk membuat objek. Saat Anda mengunggah objek menggunakan API REST, nama metadata opsional yang ditentukan pengguna harus dimulai dengan x-amz-meta- untuk membedakannya dari header HTTP lainnya. Saat Anda mengambil objek menggunakan API REST, prefiks ini akan ditampilkan. Saat Anda mengunggah objek menggunakan SOAP API, prefiks tidak dibutuhkan. Saat Anda mengambil objek menggunakan SOAP API, prefiks akan dihapus, tanpa menghiraukan API apa yang Anda gunakan untuk mengunggah objek tersebut.

catatan

SOAP API untuk Amazon S3 tidak tersedia untuk pelanggan baru, dan mendekati End of Life (EOL) pada 31 Agustus 2025. Kami menyarankan Anda menggunakan REST API atau AWS SDK.

Saat metadata diambil melalui API REST, Amazon S3 menggabungkan header yang memiliki nama yang sama (kasus pengabaian) ke dalam daftar yang dibatasi koma. Jika beberapa metadata berisi karakter yang tidak dapat dicetak, maka metadata tidak akan ditampilkan. Sebaliknya, header x-amz-missing-meta ditampilkan dengan nilai jumlah dari entri metadata yang tidak dapat dicetak. Tindakan HeadObject mengambil metadata dari sebuah objek tanpa mengembalikan objek itu sendiri. Operasi ini berguna jika Anda hanya tertarik pada metadata objek. Untuk menggunakan HEAD, Anda harus memiliki akses READ ke objek. Untuk informasi selengkapnya, lihat HeadObjectdi Referensi API Amazon Simple Storage Service.

User-defined metadata adalah satu set pasangan kunci-nilai. Amazon S3 menyimpan kunci metadata yang ditentukan pengguna dalam huruf kecil.

Amazon S3 memungkinkan karakter Unicode arbitrer dalam nilai metadata Anda.

Untuk menghindari masalah yang terkait dengan penyajian nilai metadata ini, Anda harus menyesuaikan diri dengan menggunakan US-ASCII karakter saat menggunakan REST dan UTF-8 saat menggunakan SOAP atau unggahan berbasis browser. POST

Saat menggunakan US-ASCII non-karakter dalam nilai metadata Anda, string Unicode yang disediakan diperiksa untuk non-karakter. US-ASCII Nilai header tersebut didekodekan karakternya sesuai RFC 2047 sebelum disimpan dan dikodekan sesuai RFC 2047 agar aman untuk email sebelum dikembalikan. Jika string hanya berisi US-ASCII karakter, itu disajikan apa adanya.

Berikut adalah contohnya.

PUT /Key HTTP/1.1
Host: amzn-s3-demo-bucket.s3.amazonaws.com
x-amz-meta-nonascii: ÄMÄZÕÑ S3

HEAD /Key HTTP/1.1
Host: amzn-s3-demo-bucket.s3.amazonaws.com
x-amz-meta-nonascii: =?UTF-8?B?w4PChE3Dg8KEWsODwpXDg8KRIFMz?=

PUT /Key HTTP/1.1
Host: amzn-s3-demo-bucket.s3.amazonaws.com
x-amz-meta-ascii: AMAZONS3

HEAD /Key HTTP/1.1
Host: amzn-s3-demo-bucket.s3.amazonaws.com
x-amz-meta-ascii: AMAZONS3
      

catatan

Header permintaan PUT dibatasi hingga ukuran 8 KB. Dalam header permintaan PUT, metadata yang ditentukan pengguna dibatasi hingga ke dalam ukuran 2 KB. Ukuran metadata yang ditentukan pengguna diukur dengan mengambil jumlah jumlah byte dalam UTF-8 pengkodean setiap kunci dan nilai.

Untuk informasi tentang mengubah metadata objek Anda setelah diunggah dengan membuat salinan objek, memodifikasinya, dan mengganti objek lama, atau membuat versi baru, lihat Mengedit metadata objek di konsol Amazon S3.

Kueri metadata Anda dan percepat penemuan data dengan S3 Metadata

Untuk dengan mudah menemukan, menyimpan, dan menanyakan metadata untuk objek S3 Anda, Anda dapat menggunakan Metadata S3. Dengan S3 Metadata, Anda dapat dengan cepat menyiapkan data untuk digunakan dalam analisis bisnis, pengambilan konten, kecerdasan buatan dan pelatihan model pembelajaran mesin (AI/ML), dan banyak lagi.

Metadata S3 mempercepat penemuan data dengan secara otomatis menangkap metadata untuk objek di bucket tujuan umum Anda dan menyimpannya dalam tabel hanya-baca dan terkelola penuh yang dapat Anda kueri. Apache Iceberg Tabel hanya baca ini disebut tabel metadata. Saat objek ditambahkan, diperbarui, dan dihapus dari bucket tujuan umum Anda, Metadata S3 secara otomatis menyegarkan tabel metadata yang sesuai untuk menampilkan perubahan terbaru.

Secara default, Metadata S3 menyediakan metadata objek yang ditentukan sistem, seperti waktu pembuatan objek dan kelas penyimpanan, dan metadata khusus, seperti tag, metadata yang ditentukan pengguna, dan anotasi. Metadata S3 juga menyediakan metadata peristiwa, seperti ketika objek diperbarui atau dihapus, dan yang membuat permintaan. Akun AWS

Tabel metadata disimpan dalam bucket tabel S3, yang menyediakan penyimpanan yang dioptimalkan untuk data tabular. Untuk menanyakan metadata Anda, Anda dapat mengintegrasikan keranjang meja Anda dengan layanan AWS analitik, seperti Amazon Athena, Amazon Redshift, dan Amazon Quick.

Untuk informasi selengkapnya tentang Metadata S3, lihat. Menemukan data Anda dengan tabel Metadata S3

System-defined metadata objek

Untuk setiap objek yang disimpan dalam sebuah bucket, Amazon S3 akan menyimpan serangkaian metadata sistem. Amazon S3 memproses metadata sistem ini sesuai dengan kebutuhan. Misalnya, Amazon S3 mempertahankan tanggal pembuatan objek dan metadata ukuran, menggunakan informasi ini sebagai bagian dari manajemen objek.

Terdapat dua kategori metadata sistem:

• Sistem dikendalikan — Metadata seperti tanggal pembuatan objek dikendalikan oleh sistem, yang berarti hanya Amazon S3 yang dapat mengubah nilai tanggal.

• Dikontrol pengguna–Metadata sistem lainnya, seperti kelas penyimpanan yang dikonfigurasi untuk objek dan apakah enkripsi di sisi server objek diaktifkan, adalah beberapa contoh metadata sistem yang nilai-nilainya Anda kendalikan. Jika bucket Anda dikonfigurasi sebagai situs web, terkadang Anda mungkin ingin mengarahkan permintaan halaman ke halaman lain atau URL eksternal. Dalam hal ini, halaman laman web adalah sebuah objek di dalam bucket Anda. Amazon S3 menyimpan nilai pengalihan halaman sebagai metadata sistem, yang dapat Anda kontrol.

  Saat membuat objek, Anda dapat mengonfigurasi nilai item metadata sistem ini, atau memperbarui nilai saat Anda membutuhkannya. Untuk informasi selengkapnya tentang kelas penyimpanan, lihat Memahami dan mengelola kelas penyimpanan Amazon S3.

  Amazon S3 menggunakan AWS KMS kunci untuk mengenkripsi objek Amazon S3 Anda. AWS KMS mengenkripsi hanya data objek. Checksum dan algoritma yang ditentukan disimpan sebagai bagian dari metadata objek. Jika enkripsi di sisi server diminta untuk objek, maka checksum disimpan dalam bentuk terenkripsi. Untuk informasi lebih lanjut tentang enkripsi di sisi server, lihat Melindungi data dengan enkripsi.

catatan

Header permintaan PUT dibatasi hingga ukuran 8 KB. Dalam header permintaan PUT, metadata yang ditentukan sistem dibatasi ke dalam ukuran 2 KB. Ukuran metadata yang ditentukan sistem diukur dengan mengambil jumlah jumlah byte dalam US-ASCII pengkodean setiap kunci dan nilai.

Tabel berikut ini menyediakan daftar metadata yang ditentukan sistem, dan apakah Anda dapat memperbaruinya.

Nama	Deskripsi	Apakah pengguna dapat mengubah nilainya?
Date	Tanggal dan waktu saat ini.	Tidak
Cache-Control	Bidang header umum yang digunakan untuk menentukan kebijakan caching.	Ya
Content-Disposition	Informasi presentasi objek.	Ya
Content-Encoding	Pengkodean konten (seperti kompresi) yang telah diterapkan pada data objek	Ya
Content-Length	Ukuran objek dalam byte.	Tidak
Content-Type	Jenis objek.	Ya
Last-Modified	Tanggal pembuatan objek atau tanggal modifikasi terakhir, mana pun yang terbaru. Untuk unggahan multibagian, tanggal pembuatan objek adalah tanggal inisiasi unggahan multibagian.	Tidak
ETag	Tag entitas (ETag) yang mewakili versi objek tertentu. Untuk objek yang tidak diunggah sebagai unggahan multibagian dan tidak dienkripsi atau dienkripsi oleh enkripsi sisi server dengan kunci terkelola Amazon S3 ()SSE-S3, ETag adalah intisari data MD5.	Tidak
x-amz-server-side-encryption	Header yang menunjukkan apakah enkripsi sisi server diaktifkan untuk objek, dan apakah enkripsi tersebut menggunakan AWS Key Management Service (AWS KMS) keys (SSE-KMS) atau menggunakan kunci enkripsi terkelola Amazon S3 (). SSE-S3 Untuk informasi selengkapnya, lihat Melindungi data dengan enkripsi di sisi klien.	Ya
x-amz-checksum-crc64nvme, x-amz-checksum-crc32, x-amz-checksum-crc32c, x-amz-checksum-sha1, x-amz-checksum-sha256	Header yang berisi checksum atau intisari objek. Biasanya, salah satu header ini akan diatur pada satu waktu, bergantung pada algoritma checksum yang Anda perintahkan untuk digunakan oleh Amazon S3. Untuk informasi selengkapnya tentang memilih algoritma checksum, lihat Memeriksa integritas objek di Amazon S3.	Tidak
x-amz-checksum-type	Tipe checksum, yang menentukan bagaimana checksum tingkat bagian digabungkan untuk membuat checksum tingkat objek untuk objek multipart.	Ya
x-amz-version-id	Versi objek tersebut. Saat Anda mengaktifkan Penentuan Versi pada bucket, Amazon S3 menetapkan ID versi ke objek yang ditambahkan ke bucket. Untuk informasi selengkapnya, lihat Mempertahankan beberapa versi objek dengan S3 Versioning.	Tidak
x-amz-delete-marker	Penanda Boolean yang mengindikasikan apakah objek tersebut adalah penanda hapus. Penanda ini hanya digunakan dalam bucket yang mengaktifkan Penentuan Versi,	Tidak
x-amz-storage-class	Kelas penyimpanan yang digunakan untuk menyimpan objek tersebut. Untuk informasi selengkapnya, lihat Memahami dan mengelola kelas penyimpanan Amazon S3.	Ya
x-amz-website-redirect-location	Sebuah header yang mengalihkan permintaan objek terkait ke objek lain di bucket yang sama, atau ke URL eksternal. Untuk informasi selengkapnya, lihat (Opsional) Mengonfigurasi pengalihan halaman web.	Ya
x-amz-server-side-encryption-aws-kms-key-id	Header yang menunjukkan ID kunci KMS enkripsi AWS KMS simetris yang digunakan untuk mengenkripsi objek. Header ini hanya digunakan ketika header x-amz-server-side-encryption muncul, dan memiliki nilai aws:kms.	Ya
x-amz-server-side-encryption-customer-algorithm	Header yang menunjukkan apakah enkripsi sisi server dengan kunci enkripsi yang disediakan pelanggan () diaktifkan. SSE-C Untuk informasi selengkapnya, lihat Menggunakan enkripsi sisi server dengan kunci yang disediakan pelanggan () SSE-C.	Ya
x-amz-tagging	Tag-set untuk objek tersebut. Kumpulan tag harus dikodekan sebagai parameter Kueri URL.	Ya