Object Storage Service：bucket-tagging

Catatan

• Untuk menambah atau memodifikasi tag bucket, Anda harus memiliki izin oss:PutBucketTagging. Untuk menanyakan tag bucket, Anda harus memiliki izin oss:GetBucketTagging. Untuk menghapus tag bucket, Anda harus memiliki izin oss:DeleteBucketTagging. Untuk informasi lebih lanjut, lihat Lampirkan kebijakan kustom ke pengguna RAM.

• Untuk ossutil versi 1.6.16 dan yang lebih baru, Anda dapat langsung menggunakan ossutil sebagai nama biner di baris perintah tanpa perlu memperbarui nama biner berdasarkan sistem operasi. Untuk ossutil sebelum versi 1.6.16, Anda perlu memperbarui nama biner sesuai dengan sistem operasi. Untuk informasi lebih lanjut, lihat Referensi perintah ossutil.

• Untuk informasi lebih lanjut tentang tag bucket, lihat Kelola tag bucket.

Tambahkan tag ke bucket atau modifikasi tag bucket

Penandaan bucket menggunakan pasangan kunci-nilai sebagai tag untuk mengidentifikasi bucket. Hanya pemilik bucket dan pengguna yang diberi izin PutBucketTags yang dapat menambahkan atau memodifikasi tag bucket. Jika pengguna lain mencoba menambahkan atau memodifikasi tag bucket, respons 403 Forbidden akan dikembalikan dengan kode kesalahan AccessDenied.

• Sintaks perintah

  ossutil bucket-tagging --method put oss://namabucket kunci#nilai

  Tabel berikut menjelaskan parameter di atas.

  Parameter	Deskripsi
  namabucket	Nama bucket tempat Anda ingin menambahkan tag atau memodifikasi tag.
  kunci#nilai	Pasangan kunci-nilai dari tag. Kunci dan nilai tag dipisahkan oleh tanda pagar (#) dan harus dikodekan dalam UTF-8. Kunci dapat memiliki panjang hingga 64 karakter dan tidak boleh mengandung awalan http://, https://, atau Aliyun. Kunci tidak boleh kosong. Nilai dapat memiliki panjang hingga 128 karakter. Nilai dapat dibiarkan kosong.

  Jika tag yang ditentukan dalam perintah tidak ada, tag tersebut akan ditambahkan ke bucket. Jika tag sudah ada, tag yang ada akan ditimpa.

• Contoh

  Perintah sampel berikut menambahkan dua tag ke bucket bernama examplebucket. Satu tag memiliki kunci tag1 dan nilai test1, sedangkan tag lainnya memiliki kunci tag2 dan nilai test2.

  ossutil bucket-tagging --method put oss://examplebucket  tag1#test1 tag2#test2

  Keluaran sampel berikut menunjukkan bahwa tag telah berhasil ditambahkan.

  0.300600(s) elapsed

Tanyakan tag bucket

• Sintaks perintah

  ossutil bucket-tagging --method get oss://namabucket

• Contoh

  Perintah sampel berikut menanyakan tag dari bucket bernama examplebucket:

  ossutil bucket-tagging --method get oss://examplebucket

  Keluaran sampel berikut menunjukkan bahwa bucket examplebucket memiliki dua tag. Salah satunya memiliki kunci tag1 dan nilai test1, sedangkan yang lainnya memiliki kunci tag2 dan nilai test2.

  index     tag key       tag value
  ---------------------------------------------------
  0         "tag1"        "test1"
  1         "tag2"        "test2"
  
  0.283359(s) elapsed

Hapus tag

• Sintaks perintah

  ossutil bucket-tagging --method delete oss://namabucket 

• Contoh

  Perintah sampel berikut menghapus semua tag dari bucket bernama examplebucket.

  Catatan

  ossutil memungkinkan Anda menghapus semua tag dari bucket. Namun, Anda tidak dapat menggunakan ossutil untuk menghapus hanya tag tertentu dari bucket. Untuk menghapus tag tertentu, gunakan operasi DeleteBucketTags.

  ossutil bucket-tagging --method delete oss://examplebucket

  Keluaran sampel berikut menunjukkan bahwa semua tag dari examplebucket telah dihapus.

  0.530750(s) elapsed

Opsi umum

Jika Anda menggunakan ossutil untuk beralih ke bucket yang terletak di wilayah lain, tambahkan opsi -e untuk menentukan Titik akhir wilayah tempat bucket tersebut berada. Jika Anda menggunakan ossutil untuk beralih ke bucket yang dimiliki oleh akun Alibaba Cloud lain, tambahkan opsi -i untuk menentukan ID AccessKey dari akun tersebut, serta opsi -k untuk menentukan Rahasia AccessKey dari akun tersebut.

ossutil bucket-tagging--method put oss://examplebucket kunci#nilai -e oss-cn-hangzhou.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Untuk informasi lebih lanjut tentang opsi umum, lihat Opsi umum.