Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Bekerja dengan metadata objek
Ada dua jenis metadata objek di Amazon S3: metadata yang ditentukan sistem dan metadata yang ditentukan pengguna. Metadata yang ditentukan sistem mencakup metadata seperti tanggal pembuatan objek, ukuran, dan kelas penyimpanan. Metadata yang ditentukan pengguna adalah metadata yang dapat Anda pilih untuk disetel pada saat Anda mengunggah objek. Metadata yang ditentukan pengguna ini adalah sekumpulan pasangan nama-nilai. Untuk informasi selengkapnya, silakan lihat Metadata objek yang ditentukan sistem dan Metadata objek yang ditentukan pengguna.
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
Kueri metadata Anda dan percepat penemuan data dengan S3 Metadata
Untuk menemukan, menyimpan, dan menanyakan metadata objek S3 dengan mudah, 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.
S3 Metadata mempercepat penemuan data dengan secara otomatis menangkap metadata untuk objek di bucket tujuan umum Anda dan menyimpannya dalam read-only, terkelola sepenuhnya Apache Iceberg tabel yang dapat Anda kueri. Tabel read-only 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 mencerminkan perubahan terbaru.
Secara default, Metadata S3 menyediakan metadata objek yang ditentukan sistem, seperti waktu pembuatan objek dan kelas penyimpanan, dan metadata khusus, seperti tag dan metadata yang ditentukan pengguna yang disertakan selama pengunggahan objek. 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. QuickSight
Untuk informasi selengkapnya tentang Metadata S3, lihat. Mempercepat penemuan data dengan Metadata S3
Metadata objek yang ditentukan sistem
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 menjumlahkan jumlah byte dalam pengodean US-ASCII dari 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-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 tertentu dari suatu objek. Untuk objek yang tidak diunggah sebagai unggahan multibagian dan tidak dienkripsi atau dienkripsi oleh enkripsi sisi server dengan kunci terkelola Amazon S3 (SSE-S3), ini adalah intisari data. ETag MD5 | Tidak |
x-amz-server-side-encryption |
Header yang menunjukkan apakah enkripsi sisi server diaktifkan untuk objek, dan apakah enkripsi tersebut menggunakan kunci AWS Key Management Service (AWS KMS) (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 di sisi server dengan kunci enkripsi yang disediakan pelanggan (SSE-C) telah diaktifkan. Untuk informasi selengkapnya, lihat Menggunakan enkripsi di 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 |
Metadata objek yang ditentukan pengguna
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
Dukungan SOAP melalui HTTP tidak digunakan lagi, tetapi SOAP masih tersedia melalui HTTPS. Fitur Amazon S3 baru tidak mendukung SOAP. Alih-alih menggunakan SOAP, kami sarankan Anda menggunakan REST API atau AWS SDKs.
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.
Metadata yang ditentukan pengguna adalah sekumpulan pasangan nilai-kunci. 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 karakter US-ASCII saat menggunakan REST dan UTF-8 saat menggunakan SOAP atau unggahan berbasis browser melalui. POST
Saat menggunakan non-US-ASCII karakter dalam nilai metadata Anda, string Unicode yang disediakan diperiksa untuk karakter. non-US-ASCII Nilai header tersebut didekodekan karakternya sesuai RFC 2047
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 menjumlahkan jumlah byte dalam pengodean UTF-8 dari 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.