Gunakan GetObjectTagging untuk kueri tag objek - Object Storage Service - Alibaba Cloud - Object Storage Service

Mengambil tag dari suatu objek.

Tentang versioning

Secara default, operasi GetObjectTagging hanya mengembalikan tag dari versi terkini objek. Anda dapat menentukan parameter versionId untuk mengambil tag dari versi objek tertentu. Jika versi yang ditentukan merupakan delete marker, OSS akan mengembalikan respons 404 Not Found.

Sintaksis permintaan

GET /objectname?tagging
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 20 Mar 2019 02:02:36 GMT
Authorization: SignatureValue

Parameter permintaan

Parameter	Type	Wajib	Deskripsi
tagging	String	Ya	Subresource yang mengidentifikasi ini sebagai operasi tagging.
versionId	String	Tidak	ID versi objek. Jika tidak ditentukan, tag dari versi terkini akan dikembalikan. Jika versi yang ditentukan adalah delete marker, OSS mengembalikan 404 Not Found.

Header permintaan

Semua header dalam permintaan GetObjectTagging merupakan common request headers. Untuk informasi selengkapnya, lihat Common request headers.

Header respons

Respons terhadap permintaan GetObjectTagging mencakup common response headers. Untuk informasi selengkapnya, lihat Common response headers.

Saat mengambil tag dari versi objek tertentu, respons juga mencakup header x-oss-version-id.

Elemen respons

Nama	Type	Deskripsi
Tagging	Container	Container akar untuk respons tagging. Node anak: TagSet
TagSet	Container	Container yang menyimpan semua tag. Node induk: Tagging Node anak: Tag
Tag	Container	Satu tag. Node induk: TagSet Node anak: Key dan Value
Key	String	Kunci tag. Node induk: Tag Tidak memiliki node anak
Value	String	Nilai tag. Node induk: Tag Tidak memiliki node anak

Contoh

Saat versioning tidak diaktifkan
Pada contoh ini, permintaan GET dikirim untuk mengambil tag dari objek objectname di bucket bucketname. Tag {a:1} dan {b:2} dikembalikan dengan kode status 200 (OK).

Permintaan contoh

GET /objectname?tagging
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 20 Mar 2019 02:02:36 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Respons contoh

200 (OK)
content-length: 209
server: AliyunOSS
x-oss-request-id: 5C919F38461FB4282600****
date: Wed, 20 Mar 2019 02:02:32 GMT
content-type: application/xml

<?xml version="1.0" encoding="UTF-8"?>
<Tagging>
  <TagSet>
    <Tag>
      <Key>a</Key>
      <Value>1</Value>
    </Tag>
    <Tag>
      <Key>b</Key>
      <Value>2</Value>
    </Tag>
  </TagSet>
</Tagging>

Saat versioning diaktifkan
Pada contoh ini, permintaan GET dikirim untuk mengambil tag dari versi tertentu objek objectname di bucket bucketname. Parameter versionId ditentukan dalam permintaan. Tag {age:18} dikembalikan dengan kode status 200 (OK).

Permintaan contoh

GET /objectname?tagging&versionId=CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0****
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 24 Jun 2020 08:50:28 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Respons contoh

200 (OK)
content-length: 161
server: AliyunOSS
x-oss-request-id: 5EF313D44506783438F3****
date: Wed, 24 Jun 2020 08:50:28 GMT
content-type: application/xml
x-oss-version-id: CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0****

<?xml version="1.0" encoding="UTF-8"?>
<Tagging>
  <TagSet>
    <Tag>
      <Key>age</Key>
      <Value>18</Value>
    </Tag>
  </TagSet>
</Tagging>

OSS SDKs

Contoh SDK untuk operasi GetObjectTagging tersedia dalam bahasa pemrograman berikut:

Tool baris perintah ossutil

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi GetObjectTagging, lihat GetObjectTagging.

Kode error

Kode error	Kode status HTTP	Deskripsi
FileAlreadyExists	409	Error yang dikembalikan karena fitur hierarchical namespace diaktifkan untuk bucket tersebut dan objek yang tag-nya ingin Anda tanyakan di bucket tersebut merupakan direktori.