Object Storage Service：PutObjectTagging

Catatan penggunaan

• Anda dapat menambahkan hingga 10 tag ke sebuah objek. Kunci tag harus unik.

• Kunci tag dapat memiliki panjang hingga 128 karakter, sedangkan nilai tag dapat mencapai 256 karakter.

• Kunci dan nilai tag bersifat peka terhadap huruf besar/kecil.

• Kunci dan nilai tag dapat berisi huruf, angka, spasi, serta karakter khusus berikut:

  + - = . _ : /

  Jika tag dalam header HTTP mengandung karakter khusus, Anda harus melakukan pengkodean URL pada kunci dan nilai tersebut.

• Mengubah tag objek tidak akan memperbarui parameter Last-Modified dari objek tersebut.

Untuk informasi lebih lanjut tentang penandaan objek, lihat Konfigurasi Penandaan Objek.

Versi

Secara default, ketika Anda memanggil PutObjectTagging, tag ditambahkan ke versi saat ini dari objek atau tag pada versi saat ini diperbarui. Anda dapat menentukan parameter versionId dalam permintaan untuk menambahkan atau memperbarui tag pada versi tertentu dari objek. Jika versi yang ditentukan adalah penanda hapus, OSS akan mengembalikan respons 404 Not Found.

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>Kunci</Key>
      <Value>Nilai</Value>
    </Tag>
  </TagSet>
</Tagging>            

Elemen permintaan

Operasi ini juga melibatkan header permintaan umum. Untuk informasi lebih lanjut, lihat Header HTTP Umum.

Contoh

• Menambahkan tag ke objek dalam bucket tanpa versi

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

  Contoh Permintaan

  PUT /objectname?tagging
  Content-Length: 114
  Host: BucketName.oss-cn-hangzhou.aliyuncs.com
  Date: Mon, 18 Mar 2019 08:25:17 GMT
  Authorization: OSS qn6q**************:77Dv****************
  <Tagging>
    <TagSet>
      <Tag>
        <Key>a</Key>
        <Value>1</Value>
      </Tag>
      <Tag>
        <Key>b</Key>
        <Value>2</Value>
      </Tag>
    </TagSet>
  </Tagging>

  Contoh Respons

  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 dengan versi aktif

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

  Contoh Permintaan

  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: OSS qn6q**************:77Dv****************
  <Tagging>
    <TagSet>
      <Tag>
        <Key>age</Key>
        <Value>18</Value>
      </Tag>
    </TagSet>
  </Tagging>

  Contoh Respons

  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 SDK

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

• Java

• Python

• Go V2

• PHP

• C++

• .NET

• Node.js

• iOS

ossutil

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

Kode kesalahan