Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Mengatur, membuat daftar, dan bekerja dengan objek Anda Di Amazon S3, Anda dapat menggunakan prefiks untuk mengatur penyimpanan Anda. Prefiks adalah pembuatan grup logis dari objek dalam bucket. Nilai prefiks mirip dengan nama direktori yang memungkinkan Anda untuk menyimpan data serupa di bawah direktori yang sama dalam sebuah bucket. Ketika Anda mengunggah objek secara terprogram, Anda dapat menggunakan prefiks untuk organisasi data Anda. Di konsol Amazon S3, prefiks disebut sebagai folder. Anda dapat melihat semua objek dan folder Anda di konsol S3 dengan menavigasi ke bucket. Anda juga dapat melihat informasi tentang setiap objek, termasuk properti objek. Untuk informasi selengkapnya tentang daftar dan organisasi data Anda di Amazon S3, lihat topik berikut. **Topics** + [Organisasi objek menggunakan prefiks](using-prefixes.md) + [Membuat daftar kunci objek secara terprogram](ListingKeysUsingAPIs.md) + [Mengatur objek di konsol Amazon S3 dengan menggunakan folder](using-folders.md) + [Melihat properti objek di konsol Amazon S3](view-object-properties.md) + [Mengkategorikan objek Anda menggunakan tag](object-tagging.md) # Organisasi objek menggunakan prefiks Anda dapat menggunakan prefiks untuk organisasi data yang Anda simpan di bucket Amazon S3. Prefiks adalah string karakter di bagian awal nama kunci objek. Prefiks dapat memiliki panjang berapa pun, tergantung pada panjang maksimum dari nama kunci objek (1.024 byte). Anda dapat menganggap prefiks sebagai cara untuk mengatur data Anda dengan cara yang mirip dengan direktori. Namun, prefiks bukan direktori. Pencarian berdasarkan prefiks membatasi hasil hanya pada kunci yang dimulai dengan prefiks tertentu. Pembatas menyebabkan operasi daftar menggabungkan semua kunci yang memiliki prefiks yang sama ke dalam satu hasil daftar ringkasan. Tujuan dari parameter prefiks dan pembatas adalah untuk membantu Anda mengatur dan kemudian menelusuri kunci Anda secara hierarki. Untuk melakukan hal ini, pertama-tama pilih sebuah pembatas untuk bucket Anda, seperti garis miring (/), yang tidak ada dalam nama kunci mana pun yang Anda antisipasi. Anda dapat menggunakan karakter lain sebagai pembatas. Tidak ada yang unik tentang karakter garis miring (/), tetapi ini adalah pembatas prefiks yang sangat umum. Selanjutnya, buat nama kunci Anda dengan menggabungkan semua tingkat hierarki yang memuatnya, pisahkan setiap tingkat dengan pembatas. Misalnya, jika Anda menyimpan informasi tentang kota, Anda mungkin mengaturnya berdasarkan benua, lalu berdasarkan negara, lalu berdasarkan provinsi atau negara bagian. Karena nama-nama ini biasanya tidak mengandung tanda baca, Anda dapat menggunakan garis miring (/) sebagai pembatas. Contoh berikut menggunakan pembatas garis miring (/). + Europe/France/Nouvelle-Aquitaine/Bordeaux + Utara America/Canada/Quebec/Montreal + Utara America/USA/Washington/Bellevue + Utara America/USA/Washington/Seattle Jika Anda menyimpan data untuk setiap kota di dunia dengan cara ini, maka pengelolaan namespace kunci datar akan terasa aneh. Dengan menggunakan `Prefix` dan `Delimiter` dengan operasi daftar, Anda dapat menggunakan hierarki yang telah Anda buat untuk mendaftarkan data Anda. Misalnya, untuk membuat daftar semua negara bagian di AS, atur `Delimiter='/'` dan `Prefix='North America/USA/'`. Untuk membuat daftar semua provinsi di Kanada yang datanya Anda miliki, atur `Delimiter='/'` dan `Prefix='North America/Canada/'`. Untuk informasi selengkapnya tentang pembatas, prefiks, dan folder bersarang, lihat [Perbedaan antara folder prefiks dan bersarang](https://repost.aws/knowledge-center/s3-prefix-nested-folders-difference). ## Membuat daftar objek menggunakan prefiks dan pembatas Jika Anda mengeluarkan permintaan daftar dengan pembatas, Anda dapat menelusuri hierarki hanya pada satu tingkat, melompati dan meringkas (mungkin jutaan) kunci yang ada di tingkat yang lebih dalam. Misalnya, asumsikan bahwa Anda memiliki bucket (*amzn-s3-demo-bucket*) dengan kunci berikut: `sample.jpg` `photos/2006/January/sample.jpg` `photos/2006/February/sample2.jpg` `photos/2006/February/sample3.jpg` `photos/2006/February/sample4.jpg` Bucket sampel hanya memiliki objek `sample.jpg` pada tingkat root. Untuk mencantumkan objek tingkat root dalam bucket saja, Anda dapat mengirimkan permintaan GET pada bucket dengan karakter pembatas garis miring (`/`). Sebagai respons, Amazon S3 mengembalikan kunci objek `sample.jpg` karena tidak mengandung karakter pembatas `/`. Semua kunci lainnya mengandung karakter pembatas. Amazon S3 mengelompokkan kunci ini dan menampilkan satu `CommonPrefixes` elemen dengan nilai prefiks `photos/`, yang merupakan sebuah substring dari awal kunci ini hingga peristiwa pertama dari pembatas yang ditentukan. **Example** ``` 1. 2. amzn-s3-demo-bucket 3. 4. 5. 1000 6. / 7. false 8. 9. sample.jpg 10. 2011-07-24T19:39:30.000Z 11. "d1a7fb5eab1c16cb4f7cf341cf188c3d" 12. 6 13. 14. 75cc57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a 15. 16. STANDARD 17. 18. 19. photos/ 20. 21. ``` Untuk informasi selengkapnya tentang membuat daftar kunci objek secara terprogram, lihat [Membuat daftar kunci objek secara terprogram](ListingKeysUsingAPIs.md). # Membuat daftar kunci objek secara terprogram Di Amazon S3, kunci dapat didaftarkan dengan prefiks. Anda dapat memilih prefiks umum untuk nama kunci terkait dan menandai kunci tersebut dengan karakter khusus yang membatasi hierarki. Anda kemudian dapat menggunakan operasi daftar untuk memilih dan menelusuri kunci secara hierarki. Hal ini mirip dengan bagaimana file disimpan dalam direktori dalam sistem file. Amazon S3 mengekspos operasi daftar yang memungkinkan Anda menghitung kunci yang terdapat dalam bucket. Kunci yang dipilih untuk pendaftaran didasarkan pada bucket dan prefiks. Misalnya, bayangkan sebuah bucket bernama "`dictionary`" yang berisi kunci untuk setiap kata dalam bahasa Inggris. Anda dapat membuat panggilan untuk mencantumkan semua kunci dalam bucket yang dimulai dengan huruf "q". Hasil daftar selalu ditampilkan dalam urutan biner UTF-8. Operasi daftar SOAP dan REST mengembalikan dokumen XML yang berisi nama kunci yang cocok dan informasi tentang objek yang diidentifikasi oleh setiap kunci. **catatan** SOAP APIs 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 SDKs. Kelompok kunci yang berbagi prefiks yang diakhiri oleh pembatas khusus dapat digabungkan dengan prefiks umum tersebut untuk tujuan pencatatan. Hal ini memungkinkan aplikasi untuk mengatur dan menelusuri kuncinya secara hierarki, seperti cara Anda mengatur file ke dalam direktori dalam sistem file. Misalnya, untuk memperluas bucket kamus agar berisi lebih dari sekadar kata-kata bahasa Inggris, Anda dapat membentuk kunci dengan mengawali setiap kata dengan bahasanya dan pembatas, seperti "`French/logical`". Dengan menggunakan skema penamaan ini dan fitur daftar hierarki, Anda hanya dapat mengambil daftar kata-kata dalam bahasa Prancis. Anda juga dapat menelusuri daftar bahasa tingkat atas yang tersedia tanpa harus mengulangi semua kunci intervensi leksikografis. Untuk informasi selengkapnya tentang aspek pendaftaran ini, lihat [Organisasi objek menggunakan prefiks](using-prefixes.md). **API REST** Jika aplikasi Anda memerlukannya, Anda dapat mengirimkan permintaan REST secara langsung. Anda dapat mengirimkan permintaan GET untuk mengembalikan beberapa atau semua objek dalam bucket atau Anda dapat menggunakan kriteria pemilihan untuk mengembalikan subset objek dalam bucket. Untuk informasi selengkapnya, lihat [GET Bucket (List Objects) Version 2](https://docs.aws.amazon.com/AmazonS3/latest/API/v2-RESTBucketGET.html) dalam *Referensi API Amazon Simple Storage Service*. **Membuat daftar implementasi efisiensi** Performa daftar tidak terpengaruh langsung oleh jumlah kunci dalam bucket Anda. Hal ini juga tidak terpengaruh dengan ada atau tidak adanya argumen `prefix`, `marker`, `maxkeys`, atau `delimiter`. **Iterasi melalui hasil multihalaman** Karena bucket dapat berisi kunci dalam jumlah yang hampir tidak terbatas, hasil lengkap dari kueri daftar bisa sangat besar. Untuk mengelola kumpulan hasil yang besar, API Amazon S3 mendukung penomoran halaman untuk membaginya menjadi beberapa respons. Setiap respons kunci daftar mengembalikan halaman hingga 1.000 kunci dengan indikator yang menunjukkan apakah respons terpotong. Anda mengirim serangkaian permintaan kunci daftar sampai Anda menerima semua kunci. AWS Pustaka pembungkus SDK menyediakan pagination yang sama. ## Contoh Saat mendaftarkan semua objek di dalam bucket Anda, perhatikan bahwa Anda harus memiliki izin `s3:ListBucket`. ------ #### [ CLI ] **daftar-objek** Contoh berikut menggunakan `list-objects` perintah untuk menampilkan nama-nama semua objek dalam bucket yang ditentukan: ``` aws s3api list-objects --bucket text-content --query 'Contents[].{Key: Key, Size: Size}' ``` Contoh menggunakan `--query` argumen untuk memfilter output `list-objects` turun ke nilai kunci dan ukuran untuk setiap objek Untuk informasi selengkapnya tentang objek, lihat [Bekerja dengan objek di Amazon S3](uploading-downloading-objects.md). + Untuk detail API, lihat [ListObjects](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/list-objects.html)di *Referensi AWS CLI Perintah*. **ls** Contoh berikut mencantumkan semua objek dan awalan dalam ember dengan menggunakan perintah. `ls` Untuk menggunakan perintah contoh ini, ganti **amzn-s3-demo-bucket** dengan nama bucket Anda. ``` $ aws s3 ls s3://amzn-s3-demo-bucket ``` + Untuk informasi selengkapnya tentang perintah tingkat tinggi`ls`, lihat [Daftar bucket dan objek](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html#using-s3-commands-listing-buckets) di *AWS Command Line Interface Panduan Pengguna*. ------ #### [ PowerShell ] **Alat untuk PowerShell V4** **Contoh 1: Perintah ini mengambil informasi tentang semua item di bucket “test-files”.** ``` Get-S3Object -BucketName amzn-s3-demo-bucket ``` **Contoh 2: Perintah ini mengambil informasi tentang item "sample.txt" dari bucket “test-files”.** ``` Get-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt ``` **Contoh 3: Perintah ini mengambil informasi tentang semua item dengan awalan “sample” dari bucket “test-files”.** ``` Get-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix sample ``` + Untuk detail API, lihat [ListObjects](https://docs.aws.amazon.com/powershell/v4/reference)di *Referensi Alat AWS untuk PowerShell Cmdlet (V4)*. **Alat untuk PowerShell V5** **Contoh 1: Perintah ini mengambil informasi tentang semua item di bucket “test-files”.** ``` Get-S3Object -BucketName amzn-s3-demo-bucket ``` **Contoh 2: Perintah ini mengambil informasi tentang item "sample.txt" dari bucket “test-files”.** ``` Get-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt ``` **Contoh 3: Perintah ini mengambil informasi tentang semua item dengan awalan “sample” dari bucket “test-files”.** ``` Get-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix sample ``` + Untuk detail API, lihat [ListObjects](https://docs.aws.amazon.com/powershell/v5/reference)di *Referensi Alat AWS untuk PowerShell Cmdlet (V5)*. ------ # Mengatur objek di konsol Amazon S3 dengan menggunakan folder Di bucket tujuan umum Amazon S3, objek adalah sumber daya utama, dan objek disimpan dalam ember. Bucket tujuan umum Amazon S3 memiliki struktur datar alih-alih hierarki seperti yang akan Anda lihat di sistem file. Namun, demi kemudahan organisasi, konsol Amazon S3 mendukung konsep *folder* sebagai pembuatan grup objek. Konsol melakukan ini dengan menggunakan *prefiks* nama bersama untuk objek yang dikelompokkan. Dengan kata lain, objek yang dikelompokkan memiliki nama yang dimulai dengan string umum. String umum ini, atau prefiks bersama, adalah nama folder. Nama objek juga disebut sebagai *nama kunci*. Misalnya, Anda dapat membuat folder di bucket tujuan umum di konsol bernama `photos` dan menyimpan objek bernama `myphoto.jpg` di dalamnya. Objek kemudian disimpan dengan nama kunci `photos/myphoto.jpg`, tempat `photos/` adalah prefiksnya. Berikut ini adalah dua contoh lainnya: + Jika Anda memiliki tiga objek di bucket tujuan umum Anda— `logs/date1.txt``logs/date2.txt`,, dan `logs/date3.txt` —konsol akan menampilkan folder bernama`logs`. Jika Anda membuka folder di konsol tersebut, anda akan melihat tiga objek: `date1.txt`, `date2.txt`, dan `date3.txt`. + Jika Anda memiliki objek bernama`photos/2017/example.jpg`, konsol akan menampilkan folder bernama `photos` yang berisi folder tersebut`2017`. Folder `2017` berisi objek`example.jpg`. Anda dapat memiliki folder di dalam folder, tetapi bukan bucket di dalam bucket. Anda dapat mengunggah dan menyalin objek secara langsung ke dalam folder. Folder dapat dibuat, dihapus, dan dipublikasikan, tetapi tidak dapat diganti namanya. Objek dapat disalin dari satu folder ke folder lainnya. **penting** Saat Anda membuat folder di konsol Amazon S3, S3 membuat objek 0-byte. Kunci objek ini diatur ke nama folder yang Anda berikan ditambah karakter garis miring (`/`). Misalnya, di konsol Amazon S3, jika Anda membuat folder bernama `photos` di bucket, konsol Amazon S3 akan membuat objek 0-byte dengan kunci. `photos/` Konsol membuat objek ini untuk mendukung gagasan folder. Selain itu, objek apa pun yang sudah ada sebelumnya yang diberi nama dengan karakter garis miring ke depan (`/`) muncul sebagai folder di konsol Amazon S3. Misalnya, objek dengan nama kunci `examplekeyname/` muncul sebagai folder di konsol Amazon S3 dan bukan sebagai objek. Jika tidak, ia berperilaku seperti objek lain dan dapat dilihat dan dimanipulasi melalui AWS Command Line Interface (AWS CLI), AWS SDKs, atau REST API. Selain itu, Anda tidak dapat mengunggah objek yang memiliki nama kunci dengan karakter garis miring ke depan (`/`) dengan menggunakan konsol Amazon S3. Namun, Anda dapat mengunggah objek yang diberi nama dengan karakter trailing forward slash (`/`) dengan menggunakan AWS Command Line Interface (AWS CLI) AWS SDKs, atau REST API. Selain itu, konsol Amazon S3 tidak menampilkan konten dan metadata untuk objek folder seperti halnya untuk objek lain. Saat Anda menggunakan konsol untuk menyalin objek bernama dengan karakter garis miring ke depan (`/`), folder baru dibuat di lokasi tujuan, tetapi data dan metadata objek tidak disalin. Juga, garis miring maju (`/`) dalam nama kunci objek mungkin memerlukan penanganan khusus. Untuk informasi selengkapnya, lihat [Menamai objek Amazon S3](object-keys.md). Untuk membuat folder di ember direktori, unggah folder. Untuk informasi selengkapnya, lihat [Mengunggah objek ke ember direktori](directory-buckets-objects-upload.md). **Topics** + [Membuat folder](#create-folder) + [Menjadikan folder publik](#public-folders) + [Menghitung ukuran folder](#calculate-folder) + [Menghapus folder](#delete-folders) ## Membuat folder Bagian ini menjelaskan cara menggunakan konsol Amazon S3 untuk membuat folder. **penting** Jika kebijakan bucket Anda mencegah pengunggahan objek ke bucket ini tanpa tag, metadata, atau penerima daftar kontrol akses (ACL), Anda tidak dapat membuat folder dengan menggunakan prosedur berikut. Sebaliknya, unggah folder kosong dan tentukan pengaturan berikut di konfigurasi unggahan. **Untuk membuat folder** 1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 1. Di panel navigasi kiri, pilih **Bucket tujuan umum**. 1. Dalam daftar bucket, pilih nama bucket tempat Anda ingin membuat folder. 1. Pada tab **Objek**, pilih **Buat folder**. 1. Masukkan nama untuk folder (misalnya, **favorite-pics**). **catatan** Nama folder tunduk pada batasan dan pedoman tertentu, dan dianggap sebagai bagian dari nama kunci objek objek, yang dibatasi hingga 1.024 byte. Untuk informasi selengkapnya, lihat [Menamai objek Amazon S3](object-keys.md). 1. (Opsional) Jika kebijakan bucket Anda mengharuskan objek dienkripsi dengan kunci enkripsi tertentu, di bawah **Enkripsi sisi server**, Anda harus memilih **Tentukan kunci enkripsi dan menentukan kunci enkripsi** yang sama saat membuat folder. Jika tidak, pembuatan folder akan gagal. 1. Pilih **Buat folder**. ## Menjadikan folder publik Kami menyarankan untuk memblokir semua akses publik ke folder dan bucket Amazon S3 Anda, kecuali Anda secara khusus memerlukan folder atau bucket publik. Saat Anda membuat folder publik, siapa pun di internet dapat melihat semua objek yang dikelompokkan ke dalam folder itu. Di konsol Amazon S3, Anda dapat membuat folder menjadi publik. Anda juga dapat menjadikan folder publik dengan membuat kebijakan bucket yang membatasi akses data berdasarkan prefiks. Untuk informasi selengkapnya, lihat [Identity and Access Management untuk Amazon S3](security-iam.md). **Awas** Setelah Anda menjadikan folder publik di konsol Amazon S3, Anda tidak dapat menjadikannya pribadi lagi. Sebaliknya, Anda harus mengatur izin untuk setiap objek individu di dalam folder publik sehingga objek tidak memiliki akses publik. Untuk informasi selengkapnya, lihat [Mengkonfigurasi ACLs](managing-acls.md). **Topics** + [Membuat folder](#create-folder) + [Menjadikan folder publik](#public-folders) + [Menghitung ukuran folder](#calculate-folder) + [Menghapus folder](#delete-folders) ## Menghitung ukuran folder Bagian ini menjelaskan cara menggunakan konsol Amazon S3 untuk menghitung ukuran folder. **Untuk menghitung ukuran folder** 1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 1. Di panel navigasi kiri, pilih **Bucket tujuan umum**. 1. Dalam daftar **Bucket tujuan umum**, pilih nama bucket tempat folder Anda disimpan. 1. Dalam daftar **Objek**, pilih kotak centang di sebelah nama folder. 1. Pilih **Tindakan**, lalu pilih **Hitung ukuran total**. **catatan** Saat Anda menjauh dari halaman, informasi folder (termasuk ukuran total) tidak lagi tersedia. Anda harus menghitung ukuran total lagi jika Anda ingin melihatnya lagi. **penting** Saat Anda menggunakan tindakan **Hitung ukuran total** pada objek atau folder yang ditentukan dalam bucket, Amazon S3 menghitung jumlah total objek dan ukuran penyimpanan total. Namun, unggahan multibagian yang tidak lengkap atau sedang berlangsung dan versi sebelumnya atau yang tidak terkini tidak dihitung dalam jumlah total objek atau ukuran total. Tindakan ini hanya menghitung jumlah total objek dan ukuran total untuk versi saat ini atau terbaru dari setiap objek yang disimpan dalam bucket. Contoh, jika ada dua versi objek di bucket Anda, maka kalkulator penyimpanan di Amazon S3 menghitungnya hanya sebagai satu objek. Akibatnya, jumlah total objek yang dihitung di konsol Amazon S3 dapat berbeda dari metrik **Hitungan Objek** yang ditunjukkan di Lensa Penyimpanan S3 dan dari jumlah yang dilaporkan oleh metrik Amazon CloudWatch . `NumberOfObjects` Demikian juga, ukuran penyimpanan total juga dapat berbeda dari metrik **Total Storage** yang ditunjukkan pada S3 Storage Lens dan dari `BucketSizeBytes` metrik yang ditunjukkan pada CloudWatch. ## Menghapus folder Bagian ini menjelaskan cara menggunakan konsol Amazon S3 untuk menghapus folder dari bucket S3. Untuk informasi selengkapnya tentang fitur dan harga Amazon S3, lihat [Amazon S3](https://aws.amazon.com/s3/). **Untuk menghapus folder dari bucket S3** 1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 1. Di panel navigasi kiri, pilih **Bucket tujuan umum**. 1. Dalam daftar **Bucket tujuan umum**, pilih nama bucket tempat Anda ingin menghapus foldernya. 1. Dalam daftar **Objek**, pilih kotak centang di sebelah folder dan objek yang ingin Anda hapus. 1. Pilih **Hapus**. 1. Pada halaman **Hapus objek**, verifikasi bahwa nama folder dan objek yang Anda pilih untuk dihapus tercantum di bawah Objek yang **ditentukan**. 1. Di dalam kotak **Hapus objek**, masukkan **delete**, dan pilih **Hapus objek**. **Awas** Tindakan ini menghapus semua objek yang telah ditentukan. Saat menghapus folder, tunggu hingga tindakan penghapusannya selesai sebelum menambahkan objek baru ke folder tersebut. Jika tidak, objek baru mungkin juga terhapus. # Melihat properti objek di konsol Amazon S3 Anda dapat menggunakan konsol Amazon S3 untuk melihat properti sebuah objek, termasuk kelas penyimpanan, pengaturan enkripsi, tanda, dan metadata. **Untuk melihat properti sebuah objek** 1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 1. Di panel navigasi kiri, pilih Bucket **tujuan umum atau ember** **Direktori**. 1. Di bucket list, pilih nama bucket yang berisi objek. 1. Di dalam daftar **Objek**, pilih nama objek yang ingin Anda lihat propertinya. **Ikhtisar objek** untuk objek Anda terbuka. Anda dapat menggulir ke bawah untuk melihat properti objek. 1. Pada halaman **Ikhtisar objek**, Anda dapat melihat atau mengonfigurasi properti berikut untuk objek tersebut. **catatan** Jika Anda mengubah properti **Kelas Penyimpanan**, ** Enkripsi**, atau **Metadata**, sebuah objek baru dibuat untuk menggantikan yang lama. Jika Penentuan Versi S3 diaktifkan, versi baru objek akan dibuat, dan objek yang sudah ada menjadi versi yang lebih lama. Peran yang mengubah properti juga menjadi pemilik objek baru (atau versi objek). Jika Anda mengubah properti **Storage Class**, **Encryption**, atau **Metadata** untuk objek yang memiliki tag yang ditentukan pengguna, Anda harus memiliki izin. `s3:GetObjectTagging` Jika Anda mengubah properti ini untuk objek yang tidak memiliki tag yang ditentukan pengguna tetapi berukuran lebih dari 16 MB, Anda juga harus memiliki izin. `s3:GetObjectTagging` Jika kebijakan bucket tujuan menolak `s3:GetObjectTagging` tindakan, properti ini untuk objek akan diperbarui, tetapi tag yang ditentukan pengguna akan dihapus dari objek, dan Anda akan menerima kesalahan. 1. **Kelas penyimpanan**–Setiap objek di Amazon S3 memiliki kelas penyimpanan yang terkait dengannya. Kelas penyimpanan yang Anda pilih untuk digunakan tergantung pada seberapa sering Anda mengakses objeknya. Kelas penyimpanan default untuk objek S3 dalam bucket tujuan umum adalah STANDARD. Kelas penyimpanan default untuk objek S3 dalam bucket direktori adalah S3 Express One Zone. Anda memilih kelas penyimpanan mana yang akan digunakan saat mengunggah sebuah objek. Untuk informasi selengkapnya tentang kelas penyimpanan, lihat [Memahami dan mengelola kelas penyimpanan Amazon S3](storage-class-intro.md). Untuk mengubah kelas penyimpanan setelah Anda mengunggah objek ke bucket tujuan umum, pilih **kelas Penyimpanan**. Pilih kelas penyimpanan yang Anda inginkan, lalu pilih **Simpan**. **catatan** Kelas penyimpanan objek dalam bucket direktori tidak dapat diubah. 1. **Pengaturan enkripsi di sisi server**–Anda dapat menggunakan enkripsi di sisi server untuk mengenkripsi objek S3 Anda. Untuk informasi selengkapnya, lihat [Menentukan enkripsi sisi server dengan (SSE-KMS) AWS KMS](specifying-kms-encryption.md) atau [Menentukan enkripsi di sisi server dengan kunci terkelola Amazon S3 (SSE-S3)](specifying-s3-encryption.md). 1. **Metadata**–Setiap objek di Amazon S3 memiliki serangkaian pasangan nilai-nama yang mewakili metadata-nya. Untuk informasi tentang menambahkan metadata ke objek S3, lihat [Mengedit metadata objek di konsol Amazon S3](add-object-metadata.md). 1. **Tag** — Anda mengkategorikan penyimpanan dengan menambahkan tag ke objek S3 dalam bucket tujuan umum. Untuk informasi selengkapnya, lihat [Mengkategorikan objek Anda menggunakan tag](object-tagging.md). 1. **Penahanan dan penyimpanan legal kunci objek** — Anda dapat mencegah objek dalam bucket tujuan umum dihapus. Untuk informasi selengkapnya, lihat [Mengunci objek dengan Object Lock](object-lock.md). # 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) # Kebijakan pemberian tag dan kontrol akses Anda juga dapat menggunakan kebijakan izin (bucket dan kebijakan pengguna) untuk mengelola izin terkait pemberian tag objek. Untuk tindakan kebijakan, lihat topik berikut: + [Operasi objek](security_iam_service-with-iam.md#using-with-s3-actions-related-to-objects) + [Operasi bucket](security_iam_service-with-iam.md#using-with-s3-actions-related-to-buckets) Tag objek memungkinkan kontrol akses yang detail untuk mengelola izin. Anda dapat memberikan izin bersyarat berdasarkan tag objek. Amazon S3 mendukung kunci kondisi berikut yang dapat Anda gunakan untuk memberikan izin bersyarat berdasarkan tag objek: + `s3:ExistingObjectTag/`–Gunakan kunci kondisi ini untuk memverifikasi bahwa tag objek yang ada memiliki kunci dan nilai tag spesifik. **catatan** Saat memberikan izin untuk operasi `PUT Object` dan `DELETE Object`, kunci kondisi ini tidak didukung. Artinya, Anda tidak dapat membuat kebijakan memberikan atau menolak izin pengguna untuk menghapus atau menimpa objek berdasarkan tag yang ada. + `s3:RequestObjectTagKeys`–Gunakan kunci kondisi ini untuk membatasi kunci tag yang ingin Anda izinkan pada objek. Ini berguna saat menambahkan tag ke objek menggunakan permintaan objek PutObjectTagging dan PutObject, dan POST. + `s3:RequestObjectTag/`–Gunakan kunci kondisi ini untuk membatasi kunci dan nilai tag yang ingin Anda izinkan pada objek. Ini berguna saat menambahkan tag ke objek menggunakan permintaan PutObjectTagging dan PutObject, dan POST Bucket. Untuk daftar lengkap kunci kondisi Amazon S3, lihat [Contoh kebijakan bucket menggunakan tombol kondisi](amazon-s3-policy-keys.md). Kebijakan izin berikut menggambarkan cara pemberian tag objek yang memungkinkan manajemen izin akses yang detail. **Example 1: Mengizinkan pengguna untuk membaca hanya objek yang memiliki tag dan nilai kunci tertentu** Kebijakan izin berikut membatasi pengguna agar hanya membaca objek yang memiliki kunci dan nilai tag `environment: production`. Kebijakan ini menggunakan kunci kondisi `s3:ExistingObjectTag` untuk menentukan kunci tag dan nilai. **** ``` { "Version":"2012-10-17", "Statement": [ { "Principal": { "AWS": [ "arn:aws:iam::111122223333:role/JohnDoe" ] }, "Effect": "Allow", "Action": ["s3:GetObject", "s3:GetObjectVersion"], "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*", "Condition": { "StringEquals": {"s3:ExistingObjectTag/environment": "production"} } } ] } ``` **Example 2: Batasi kunci tag objek mana yang dapat ditambahkan pengguna** Kebijakan izin berikut memberikan izin pengguna untuk melakukan tindakan `s3:PutObjectTagging`, yang memungkinkan pengguna menambahkan tag ke objek yang sudah ada. Kondisi ini menggunakan kunci kondisi `s3:RequestObjectTagKeys` untuk menentukan kunci tag yang diizinkan, seperti `Owner` atau `CreationDate`. Untuk informasi selengkapnya, lihat [Membuat kondisi yang menguji beberapa nilai kunci](https://docs.aws.amazon.com//IAM/latest/UserGuide/reference_policies_multi-value-conditions.html) dalam *Panduan Pengguna IAM*. Kebijakan ini memastikan agar setiap kunci tag yang ditentukan dalam permintaan adalah kunci tag yang diotorisasi. Kualifikasi `ForAnyValue` dalam kondisi tersebut memastikan bahwa setidaknya ada satu kunci yang ditentukan dalam permintaan. **** ``` { "Version":"2012-10-17", "Statement": [ {"Principal":{"AWS":[ "arn:aws:iam::111122223333:role/JohnDoe" ] }, "Effect": "Allow", "Action": [ "s3:PutObjectTagging" ], "Resource": [ "arn:aws:s3:::amzn-s3-demo-bucket/*" ], "Condition": {"ForAnyValue:StringEquals": {"s3:RequestObjectTagKeys": [ "Owner", "CreationDate" ] } } } ] } ``` **Example 3: Memerlukan kunci dan nilai tag spesifik saat mengizinkan pengguna untuk menambahkan tag objek** Kebijakan contoh berikut memberikan izin pengguna untuk melakukan `s3:PutObjectTagging` tindakan, yang memungkinkan pengguna menambahkan tag ke objek yang sudah ada. Kondisi ini mengharuskan pengguna untuk menyertakan kunci tag tertentu (seperti `Project`) dengan set nilai ke `X`. **** ``` { "Version":"2012-10-17", "Statement": [ {"Principal":{"AWS":[ "arn:aws:iam::111122223333:user/JohnDoe" ] }, "Effect": "Allow", "Action": [ "s3:PutObjectTagging" ], "Resource": [ "arn:aws:s3:::amzn-s3-demo-bucket/*" ], "Condition": {"StringEquals": {"s3:RequestObjectTag/Project": "X" } } } ] } ``` # Mengelola tag objek Bagian ini menjelaskan bagaimana Anda dapat mengelola tag objek menggunakan AWS SDKs untuk Java dan .NET atau konsol Amazon S3. Penandaan objek memberi Anda cara untuk mengkategorikan penyimpanan dalam ember tujuan umum. Setiap tag adalah pasangan nilai kunci yang mematuhi aturan berikut: + 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 tag objek, lihat [Mengkategorikan objek Anda menggunakan tag](object-tagging.md). Untuk informasi selengkapnya tentang pembatasan tag, lihat [Pembatasan Tag yang Ditentukan Pengguna](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html) dalam *AWS Manajemen Penagihan dan Biaya Panduan Pengguna*. ## Menggunakan konsol S3 **Untuk menambahkan tag ke objek** 1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 1. Di panel navigasi kiri, pilih **Bucket tujuan umum**. 1. Di bucket list, pilih nama bucket yang berisi objek. 1. Pilih kotak centang di sebelah kiri nama objek yang ingin Anda ubah. 1. Di menu **Tindakan**, pilih **Edit tag**. 1. Tinjau objek yang tercantum, lalu pilih **Tambahkan tag**. 1. Setiap tag objek adalah pasangan nilai kunci. Masukkan **Kunci** dan **Nilai**. Untuk menambahkan tag lainnya, pilih **Tambahkan tag**. Anda dapat memasukkan hingga 10 tag untuk objek. 1. Pilih **Simpan perubahan**. Amazon S3 menambahkan tag ke objek tertentu. Untuk informasi selengkapnya, lihat juga [Melihat properti objek di konsol Amazon S3](view-object-properties.md) dan [Mengunggah Objek](upload-objects.md) dalam panduan ini. ## Menggunakan AWS SDKs ------ #### [ Java ] Untuk mengelola tag objek menggunakan AWS SDK for Java, Anda dapat mengatur tag untuk objek baru dan mengambil atau mengganti tag untuk objek yang ada. Untuk informasi selengkapnya tentang pemberian tag objek, lihat [Mengkategorikan objek Anda menggunakan tag](object-tagging.md). Unggah objek ke bucket dan tetapkan tanda menggunakan S3Client. Sebagai contoh, lihat [Mengunggah objek ke bucket di Referensi](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_PutObject_section.html) *API Amazon S3*. ------ #### [ .NET ] Contoh berikut menunjukkan bagaimana menggunakan AWS SDK untuk .NET untuk mengatur tag untuk objek baru dan mengambil atau mengganti tag untuk objek yang ada. Untuk informasi selengkapnya tentang pemberian tag objek, lihat [Mengkategorikan objek Anda menggunakan tag](object-tagging.md). Untuk informasi tentang menyiapkan dan menjalankan contoh kode, lihat [Memulai SDK for .NET di AWSAWS SDK for](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/net-dg-setup.html) .NET *Developer Guide*. ``` using Amazon; using Amazon.S3; using Amazon.S3.Model; using System; using System.Collections.Generic; using System.Threading.Tasks; namespace Amazon.DocSamples.S3 { public class ObjectTagsTest { private const string bucketName = "*** bucket name ***"; private const string keyName = "*** key name for the new object ***"; private const string filePath = @"*** file path ***"; // Specify your bucket region (an example region is shown). private static readonly RegionEndpoint bucketRegion = RegionEndpoint.USWest2; private static IAmazonS3 client; public static void Main() { client = new AmazonS3Client(bucketRegion); PutObjectWithTagsTestAsync().Wait(); } static async Task PutObjectWithTagsTestAsync() { try { // 1. Put an object with tags. var putRequest = new PutObjectRequest { BucketName = bucketName, Key = keyName, FilePath = filePath, TagSet = new List{ new Tag { Key = "Keyx1", Value = "Value1"}, new Tag { Key = "Keyx2", Value = "Value2" } } }; PutObjectResponse response = await client.PutObjectAsync(putRequest); // 2. Retrieve the object's tags. GetObjectTaggingRequest getTagsRequest = new GetObjectTaggingRequest { BucketName = bucketName, Key = keyName }; GetObjectTaggingResponse objectTags = await client.GetObjectTaggingAsync(getTagsRequest); for (int i = 0; i < objectTags.Tagging.Count; i++) Console.WriteLine("Key: {0}, Value: {1}", objectTags.Tagging[i].Key, objectTags.Tagging[i].Value); // 3. Replace the tagset. Tagging newTagSet = new Tagging(); newTagSet.TagSet = new List{ new Tag { Key = "Key3", Value = "Value3"}, new Tag { Key = "Key4", Value = "Value4" } }; PutObjectTaggingRequest putObjTagsRequest = new PutObjectTaggingRequest() { BucketName = bucketName, Key = keyName, Tagging = newTagSet }; PutObjectTaggingResponse response2 = await client.PutObjectTaggingAsync(putObjTagsRequest); // 4. Retrieve the object's tags. GetObjectTaggingRequest getTagsRequest2 = new GetObjectTaggingRequest(); getTagsRequest2.BucketName = bucketName; getTagsRequest2.Key = keyName; GetObjectTaggingResponse objectTags2 = await client.GetObjectTaggingAsync(getTagsRequest2); for (int i = 0; i < objectTags2.Tagging.Count; i++) Console.WriteLine("Key: {0}, Value: {1}", objectTags2.Tagging[i].Key, objectTags2.Tagging[i].Value); } catch (AmazonS3Exception e) { Console.WriteLine( "Error encountered ***. Message:'{0}' when writing an object" , e.Message); } catch (Exception e) { Console.WriteLine( "Encountered an error. Message:'{0}' when writing an object" , e.Message); } } } } ``` ------