Gunakan PutObjectTagging untuk menambah atau memperbarui tag objek - Object Storage Service - Alibaba Cloud - Object Storage Service

Menambahkan tag ke objek atau memperbarui tag yang telah ditambahkan ke objek. Setiap tag yang ditambahkan ke objek merupakan pasangan kunci-nilai.

Catatan penggunaan

Anda dapat menambahkan hingga 10 tag ke suatu objek. Kunci tag pada objek harus unik.
Panjang kunci tag dapat mencapai 128 karakter, sedangkan panjang nilai tag dapat mencapai 256 karakter.
Kunci dan nilai tag bersifat case-sensitive.
Kunci dan nilai tag dapat berisi huruf, angka, spasi, serta karakter khusus berikut:

+ - = . _ : /

Jika tag dalam header HTTP mengandung karakter tersebut, Anda harus melakukan URL encoding pada kunci dan nilai tag tersebut.
Mengubah tag suatu objek tidak memperbarui parameter Last-Modified objek tersebut.

Untuk informasi selengkapnya tentang tag objek, lihat Konfigurasikan penandaan objek.

Pengendalian versi

Secara default, saat Anda memanggil PutObjectTagging untuk menambahkan atau memperbarui tag pada objek, operasi tersebut akan diterapkan pada versi terkini objek. Anda dapat menentukan parameter versionId dalam permintaan untuk menambahkan atau memperbarui tag pada versi tertentu objek. Jika versi yang ditentukan adalah penanda hapus, OSS akan mengembalikan respons 404 Not Found.

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 Bucket Policy.

API	Action	Description
PutObjectTagging	oss:PutObjectTagging	Menambahkan atau memodifikasi tag suatu objek.
PutObjectTagging	oss:PutObjectVersionTagging	Menambahkan atau memodifikasi tag versi tertentu dari suatu objek.

Sintaksis permintaan

PUT /objectname?tagging
Content-Length: 114
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Mon, 18 Mar 2019 08:25:17 GMT
Authorization: SignatureValue
<Tagging>
  <TagSet>
    <Tag>
      <Key>Key</Key>
      <Value>Value</Value>
    </Tag>
  </TagSet>
</Tagging>

Elemen permintaan

Element	Type	Required	Example	Description
Tagging	Container	Yes	N/A	Kontainer tingkat teratas. Node anak: TagSet
TagSet	Container	Yes	N/A	Tag-tag tersebut. Node induk: Tagging Node anak: Tag
Tag	Container	No	N/A	Tag tersebut. Node induk: TagSet Node anak: Key dan Value
Key	String	No	a	Kunci tag tersebut. Node induk: Tag Node anak: none
Value	String	No	1	Nilai tag tersebut. Node induk: Tag Node anak: none

Operasi ini juga melibatkan header permintaan umum. Untuk informasi selengkapnya, lihat Header HTTP umum.

Contoh

Menambahkan tag ke objek dalam bucket tanpa pengendalian versi

Dalam contoh ini, objek bernama objectname disimpan dalam bucket tanpa pengendalian versi bernama bucketname. Permintaan PutObjectTagging dikirim untuk menambahkan tag {a:1} dan {b:2} ke objek tersebut. Setelah kedua tag ditambahkan, respons 200 (OK) dikembalikan.

Permintaan contoh

PUT /objectname?tagging
Content-Length: 114
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Mon, 18 Mar 2019 08:25:17 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
<Tagging>
  <TagSet>
    <Tag>
      <Key>a</Key>
      <Value>1</Value>
    </Tag>
    <Tag>
      <Key>b</Key>
      <Value>2</Value>
    </Tag>
  </TagSet>
</Tagging>

Tanggapan contoh

200 (OK)
content-length: 0
server: AliyunOSS
connection: keep-alive
x-oss-request-id: 5C8F55ED461FB4A64C00****
date: Mon, 18 Mar 2019 08:25:17 GMT

Menambahkan tag ke objek dalam bucket yang diaktifkan pengendalian versinya

Dalam contoh ini, objek bernama objectname disimpan dalam bucket dengan pengendalian versi bernama bucketname. Permintaan PutObjectTagging dikirim untuk menambahkan tag {age:18} ke versi tertentu dari objectname. Setelah tag tersebut ditambahkan, respons 200 (OK) dikembalikan.

Permintaan contoh

PUT /objectname?tagging&versionId=CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0****
Content-Length: 90
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 24 Jun 2020 08:58:15 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
<Tagging>
  <TagSet>
    <Tag>
      <Key>age</Key>
      <Value>18</Value>
    </Tag>
  </TagSet>
</Tagging>

Tanggapan contoh

200 (OK)
content-length: 0
server: AliyunOSS
connection: keep-alive
x-oss-request-id: 5EF315A7FBD3EC3232B4****
date: Wed, 24 Jun 2020 08:58:15 GMT
x-oss-version-id: CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0****

OSS SDKs

Anda dapat menggunakan OSS SDK untuk bahasa pemrograman berikut untuk memanggil operasi PutObjectTagging:

ossutil

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi PutObjectTagging, lihat put-object-tagging.

Kode error

Error code	HTTP status code	Description
FileAlreadyExists	409	Objek yang ingin Anda konfigurasikan atau perbarui tag-nya merupakan direktori dalam bucket yang memiliki fitur hierarchical namespace yang diaktifkan.