Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengkategorikan objek Anda menggunakan tag
Gunakan pemberian tag objek untuk mengategorikan penyimpanan. Setiap tag adalah pasangan nilai kunci.
Anda dapat menambahkan tag ke objek baru saat mengunggahnya, atau Anda dapat menambahkannya ke objek yang sudah ada.
+ Anda dapat mengaitkan hingga 10 tag dengan objek. Tag yang terkait dengan sebuah objek harus memiliki kunci tag unik.
+ Kunci tanda dapat terdiri dari hingga 128 karakter Unicode, dan nilai tanda dapat terdiri dari hingga 256 karakter Unicode. Tag objek Amazon S3 diwakili secara internal dalam UTF-16. Perhatikan bahwa dalam UTF-16, karakter menggunakan 1 atau 2 posisi karakter.
+ Kunci dan nilai peka terhadap huruf besar dan kecil.
+ Untuk informasi selengkapnya tentang pembatasan tag, lihat [Pembatasan tag yang ditentukan pengguna di Panduan](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/custom-tags.html#allocation-tag-restrictions) Pengguna *AWS Billing and Cost Management*. Untuk pembatasan tag dasar, lihat [Pembatasan tag](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#tag-restrictions) di *Panduan Pengguna Amazon EC2*.
**Contoh**
Pertimbangkan contoh pemberian tag berikut:
**Example Informasi PHI**
Misalkan objek berisi data informasi kesehatan yang dilindungi (PHI). Anda dapat memberi tag pada objek menggunakan pasangan nilai kunci berikut.
```
PHI=True
```
atau
```
Classification=PHI
```
**Example File proyek**
Misalkan, Anda menyimpan berkas proyek dalam bucket S3. Anda dapat memberi tag objek ini dengan kunci yang diberi nama `Project` dan nilai, seperti yang ditunjukkan berikut ini.
```
Project=Blue
```
**Example Banyak tag**
Anda dapat menambahkan beberapa tag ke sebuah objek, seperti yang ditunjukkan berikut.
```
Project=x
Classification=confidential
```
**Prefiks nama kunci dan tag**
Prefiks kunci objek juga memungkinkan Anda untuk mengategorikan penyimpanan. Namun, kategorisasi berbasis prefiks bersifat satu dimensi. Pertimbangkan nama kunci objek berikut:
```
photos/photo1.jpg
project/projectx/document.pdf
project/projecty/document2.pdf
```
Nama-nama kunci ini memiliki prefiks `photos/`, `project/projectx/`, dan `project/projecty/`. Prefiks ini mengaktifkan kategorisasi satu dimensi. Artinya, semua yang berada di bawah prefix adalah satu kategori. Misalnya, prefiks `project/projectx` mengidentifikasi semua dokumen yang terkait dengan proyek x.
Dengan pemberian tag, Anda sekarang memiliki dimensi lain. Jika Anda ingin foto1 dalam kategori proyek x, Anda dapat memberi tag objek yang sesuai.
**Manfaat tambahan**
Selain klasifikasi data, pemberian tag menawarkan manfaat seperti berikut ini:
+ Tag objek memungkinkan kontrol izin akses yang detail. Misalnya, Anda dapat memberikan izin pengguna ke objek hanya-baca dengan tag tertentu.
+ Tag objek memungkinkan manajemen siklus hidup objek yang detail yaitu Anda dapat menentukan filter berbasis tag, selain prefiks nama kunci, dalam aturan siklus hidup.
+ Saat menggunakan analitik Amazon S3, Anda dapat mengonfigurasi filter agar membuat grup objek secara bersama-sama untuk analisis dengan tag objek, dengan prefiks nama kunci, atau dengan prefiks dan tag.
+ Anda juga dapat menyesuaikan CloudWatch metrik Amazon untuk menampilkan informasi berdasarkan filter tag tertentu. Bagian berikut memberikan perincian.
**penting**
Dapat menggunakan tag untuk melabeli objek yang berisi data rahasia, seperti informasi pengenal pribadi (PII) atau informasi kesehatan terlindungi (PHI). Namun demikian, tag itu sendiri seharusnya tidak berisi informasi rahasia.
**Menambahkan set tag objek ke beberapa objek Amazon S3 dengan permintaan tunggal**
Untuk menambahkan set tag objek ke lebih dari satu objek Amazon S3 dengan permintaan tunggal, Anda dapat menggunakan Operasi Batch S3. Anda menyediakan daftar objek yang akan dioperasikan kepada Operasi Batch S3. Operasi Batch S3 akan memanggil masing-masing operasi API untuk melakukan operasi tertentu. Satu tugas Operasi Batch dapat melakukan operasi tertentu pada miliaran objek yang berisi data sebesar eksabita.
Operasi Batch S3 memiliki fitur melacak progres, mengirimkan notifikasi, dan menyimpan laporan penyelesaian terperinci dari semua tindakan, menyediakan pengalaman yang dikelola sepenuhnya, dapat diaudit, dan nirserver. Anda dapat menggunakan Operasi Batch S3 melalui konsol Amazon S3 AWS CLI, AWS SDKs, atau REST API. Untuk informasi selengkapnya, lihat [Dasar-dasar Operasi Batch S3](batch-ops.md#batch-ops-basics).
Untuk informasi selengkapnya tentang tag objek, lihat [Mengelola tag objek](tagging-managing.md).
## Operasi API terkait pemberian tag objek
Amazon S3 mendukung operasi API berikut yang khusus untuk pemberian tag objek:
**Operasi API objek**
+ [Pemberian tag PUT Objek](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPUTtagging.html)–Mengganti tag pada satu objek. Anda menentukan tag di isi permintaan. Ada dua skenario berbeda dalam pengelolaan tag objek menggunakan API ini.
+ Objek tidak memiliki tag–Dengan menggunakan API ini, Anda dapat menambahkan satu set tag ke objek (objek tidak memiliki tag sebelumnya).
+ Objek memiliki satu set tag yang sudah ada–Untuk memodifikasi tag yang sudah ada, Anda harus mengambil set tag yang sudah ada terlebih dahulu, mengubahnya dari sisi klien, kemudian menggunakan API ini untuk mengganti set tag tersebut.
**catatan**
Jika Anda mengirim permintaan ini dengan set tag kosong, Amazon S3 menghapus tag yang ada yang ditetapkan di objek. Jika Anda menggunakan metode ini, Anda akan dikenakan biaya untuk Permintaan Tingkat 1 (PUT). Untuk informasi selengkapnya, lihat [harga Amazon S3](https://d0.awsstatic.com/whitepapers/aws_pricing_overview.pdf).
Permintaan [pemberian tag DELETE Object](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETEtagging.html) lebih disarankan karena mencapai hasil yang sama tanpa dikenakan biaya.
+ [Pemberian tag GET Object](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGETtagging.html)–Mengembalikan set tag yang terkait dengan objek. Amazon S3 mengembalikan tag objek di dalam isi respons.
+ [Pemberian tag DELETE Object](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETEtagging.html)–Menghapus set tag yang terkait dengan objek.
**Operasi API lainnya yang mendukung pemberian tag**
+ [PUT Objek](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPUT.html) dan [Memulai Pengunggahan Multibagian](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadInitiate.html)– Anda dapat menentukan tag saat membuat objek. Anda menentukan tag menggunakan header permintaan `x-amz-tagging`.
+ [GET Object](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGET.html)–Alih-alih mengembalikan set tag, Amazon S3 mengembalikan jumlah tag objek dalam header `x-amz-tag-count` (hanya jika pemohon memiliki izin untuk membaca tag) karena ukuran respons header terbatas hingga 8 K byte. Jika Anda ingin melihat tag, Anda membuat permintaan lain untuk operasi API [pemberian tag GET Object](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGETtagging.html).
+ [Objek POST](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOST.html)–Anda dapat menentukan tag di permintaan POST.
Selama tag dalam permintaan Anda tidak melebihi batas ukuran header permintaan HTTP 8 K byte, Anda dapat menggunakan API `PUT Object ` untuk membuat objek dengan tag. Jika tag yang Anda tetapkan melebihi batas ukuran header, Anda dapat menggunakan metode POST ini yaitu Anda menyertakan tag di dalam bodi.
[PUT Objek-Salin](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectCOPY.html)–Anda dapat menentukan `x-amz-tagging-directive` dalam permintaan Anda untuk mengarahkan Amazon S3 agar menyalin (perilaku default) tag atau mengganti tag dengan set tag baru yang diberikan dalam permintaan.
Perhatikan hal berikut:
+ Pemberian Tag Objek S3 sangat konsisten. Untuk informasi selengkapnya, lihat [Model konsistensi data Amazon S3](Welcome.md#ConsistencyModel).
## Konfigurasi tambahan
Bagian ini menjelaskan bagaimana pemberian tag objek berkaitan dengan konfigurasi lain.
### Pemberian tag objek dan manajemen siklus hidup
Dalam konfigurasi siklus operasional bucket, Anda dapat menetapkan filter untuk memilih subset objek yang aturannya berlaku. Anda dapat menentukan filter berdasarkan prefiks nama kunci, tag objek, atau keduanya.
Misalkan Anda menyimpan foto (format mentah dan yang sudah jadi) dalam bucket Amazon S3. Anda dapat memberi tag objek ini seperti yang ditunjukkan berikut ini.
```
phototype=raw
or
phototype=finished
```
Anda dapat mempertimbangkan untuk mengarsipkan foto mentah ke Amazon Glacier beberapa saat setelah dibuat. Anda dapat mengonfigurasi aturan siklus aktif dengan filter yang mengidentifikasi subset objek dengan prefiks nama kunci (`photos/`) yang memiliki tag tertentu (`phototype=raw`).
Untuk informasi selengkapnya, lihat [Mengelola siklus hidup objek](object-lifecycle-mgmt.md).
### Pemberian tag dan replikasi objek
Jika Anda mengonfigurasi Replikasi pada bucket, Amazon S3 mereplikasi tag, asalkan Anda memberikan izin Amazon S3 untuk membaca tag tersebut. Untuk informasi selengkapnya, lihat [Menyiapkan ikhtisar replikasi langsung](replication-how-setup.md).
### Pemberitahuan peristiwa pemberian tag objek
Anda dapat mengatur pemberitahuan peristiwa Amazon S3 untuk menerima pemberitahuan saat tag objek ditambahkan atau dihapus dari objek. Jenis peristiwa `s3:ObjectTagging:Put` memberi tahu Anda saat tag PUT pada objek atau saat tag yang ada diperbarui. Jenis peristiwa `s3:ObjectTagging:Delete` memberi tahu Anda saat tag dihapus dari objek. Untuk informasi selengkapnya, lihat [Mengaktifkan pemberitahuan peristiwa](https://docs.aws.amazon.com/AmazonS3/latest/userguide/how-to-enable-disable-notification-intro.html).
Untuk informasi lebih lanjut tentang pemberian tag objek, lihat topik berikut ini:
**Topics**
+ [Operasi API terkait pemberian tag objek](#tagging-apis)
+ [Konfigurasi tambahan](#tagging-other-configs)
+ [Kebijakan pemberian tag dan kontrol akses](tagging-and-policies.md)
+ [Mengelola tag objek](tagging-managing.md)