PutBucketTags - Object Storage Service

Menambahkan atau memodifikasi tag pada bucket.

Catatan penggunaan

Saat memanggil operasi PutBucketTags, perhatikan hal-hal berikut:

Hanya pemilik bucket dan pengguna RAM yang berwenang yang dapat mengonfigurasi tag untuk bucket tersebut. Jika pengguna lain mencoba mengonfigurasi tag untuk bucket, respons 403 Forbidden akan dikembalikan dengan kode kesalahan AccessDenied.
Anda dapat mengonfigurasi hingga 20 tag untuk sebuah bucket. Setiap tag merupakan pasangan nilai-kunci.
Ketika Anda memanggil PutBucketTags untuk menambahkan tag ke bucket, tag baru akan menimpa tag yang ada dengan kunci yang sama.

Izin

Secara default, akun Alibaba Cloud memiliki izin penuh. Pengguna RAM atau Peran RAM di bawah akun Alibaba Cloud tidak memiliki izin apa pun secara default. Akun Alibaba Cloud atau administrator akun harus memberikan izin operasi melalui Kebijakan RAM atau Kebijakan Bucket.

API	Aksi	Definisi
PutBucketTags	oss:PutBucketTagging	Menambahkan tag ke atau memodifikasi tag dari bucket.

Sintaks permintaan

PUT /?tagging HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Authorization: SignatureValue
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
<?xml version="1.0" encoding="UTF-8"?>
<Tagging>
  <TagSet>
    <Tag>
      <Key>key1</Key>
      <Value>value1</Value>
    </Tag>
    <Tag>
      <Key>key2</Key>
      <Value>value2</Value>
    </Tag>
  </TagSet>
</Tagging>

Header permintaan

Permintaan PutBucketTags hanya mencakup header permintaan umum. Untuk informasi lebih lanjut, lihat Header Permintaan Umum.

Elemen permintaan

Elemen	Tipe	Diperlukan	Deskripsi
Tagging	Container	Ya	Wadah yang digunakan untuk menyimpan TagSet. Node anak: TagSet Node induk: tidak ada
TagSet	Container	Ya	Wadah yang digunakan untuk menyimpan satu set Tags. Node anak: Tag Node induk: Tagging
Tag	Container	Ya	Wadah yang digunakan untuk menyimpan tag yang ingin Anda tambahkan atau modifikasi. Node anak: Key dan Value Node induk: TagSet
Key	STRING	Ya	Kunci dari sebuah tag. Panjang kunci tag maksimal adalah 64 byte. Kunci tag tidak boleh dimulai dengan `http://`, `https://`, atau `Aliyun`. Kunci tag harus dienkripsi dalam format UTF-8. Nilai elemen ini tidak boleh kosong. Node anak: tidak ada Node induk: Tag
Value	STRING	Tidak	Nilai dari sebuah tag. Panjang nilai tag maksimal adalah 128 byte. Nilai tag harus dienkripsi dalam format UTF-8. Parameter ini bisa dibiarkan kosong. Node anak: tidak ada Node induk: Tag

Header respons

Respons terhadap permintaan PutBucketTags hanya mencakup header respons umum. Untuk informasi lebih lanjut, lihat Header Respons Umum.

Contoh

Contoh Permintaan

PUT /?tagging
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 17 Apr 2025 11:49:13 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
<Tagging>
  <TagSet>
    <Tag>
      <Key>testa</Key>
      <Value>testv1</Value>
    </Tag>
    <Tag>
      <Key>testb</Key>
      <Value>testv2</Value>
    </Tag>
  </TagSet>
</Tagging>

Contoh Respons

200 (OK)
content-length: 0
server: AliyunOSS
x-oss-request-id: 5C1B138A109F4E405B2D****
date: Thu, 20 Dec 2018 11:59:06 GMT
x-oss-server-time: 148
connection: keep-alive

OSS SDKs

Anda dapat menggunakan Object Storage Service (OSS) SDK untuk bahasa pemrograman berikut guna memanggil operasi PutBucketTags:

ossutil

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi PutBucketTags, lihat put-bucket-tags.