Operasi ini digunakan untuk menanyakan tag dari sebuah objek.
Versioning
Secara default, ketika Anda memanggil GetObjectTagging, hanya tag dari versi saat ini dari objek yang dikembalikan. Untuk menanyakan tag dari versi tertentu, Anda dapat menentukan parameter versionId dalam permintaan. Jika versi saat ini adalah penanda hapus, OSS akan mengembalikan respons 404 Not Found.
Syntax
GET /objectname?tagging
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 20 Mar 2019 02:02:36 GMT
Authorization: SignatureValueHeader Permintaan
Semua header dalam permintaan GetObjectTagging merupakan header umum. Untuk informasi lebih lanjut, lihat Header Permintaan Umum.
Header respons
Semua header dalam respons terhadap permintaan GetObjectTagging merupakan header umum. Untuk informasi lebih lanjut, lihat Header Respons Umum.
Elemen respons
Elemen | Tipe | Deskripsi |
Tagging | Container | Wadah yang digunakan untuk menyimpan kumpulan tag. Node anak: TagSet |
TagSet | Container | Kumpulan tag. Node induk: Tagging Node anak: Tag |
Tag | Container | Kumpulan tag. Node induk: TagSet Node anak: Key dan Value |
Key | String | Kunci dari tag objek. Node induk: Tag Node anak: tidak ada |
Value | String | Nilai dari tag objek. Node induk: Tag Node anak: tidak ada |
Contoh
Menanyakan tag dari sebuah objek dalam bucket tanpa versi.
Dalam contoh ini, objek bernama objectname disimpan dalam bucket tanpa versi bernama bucketname. Permintaan GetObjectTagging dikirim untuk menanyakan tag {a:1} dan {b:2} dari objectname. Setelah tag diperoleh, respons 200 OK dikembalikan.
Contoh Permintaan
GET /objectname?tagging Host: BucketName.oss-cn-hangzhou.aliyuncs.com Date: Wed, 20 Mar 2019 02:02:36 GMT Authorization: OSS qn6q**************:77Dv****************Contoh Respons
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>Menanyakan tag dari sebuah objek dalam bucket berbasis versi.
Dalam contoh ini, objek bernama objectname disimpan dalam bucket berbasis versi bernama bucketname. Permintaan GetObjectTagging dikirim untuk menanyakan tag {age:18} dari versi tertentu dari objectname. Setelah tag dari versi tersebut diperoleh, respons 200 OK dikembalikan.
Contoh Permintaan
GET /objectname?tagging&versionId=CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0**** Host: BucketName.oss-cn-hangzhou.aliyuncs.com Date: Wed, 24 Jun 2020 08:50:28 GMT Authorization: OSS qn6q**************:77Dv****************Contoh Respons
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
Anda dapat menggunakan OSS SDK untuk bahasa pemrograman berikut guna memanggil operasi GetObjectTagging:
ossutil
Untuk informasi tentang perintah ossutil yang sesuai dengan operasi GetObjectTagging, lihat get-object-tagging.
Kode kesalahan
Kode kesalahan | Kode status HTTP | Deskripsi |
FileAlreadyExists | 409 | Pesan kesalahan dikembalikan karena objek yang konfigurasi tagging-nya ingin Anda tanyakan adalah direktori dalam bucket dengan fitur namespace hierarkis diaktifkan. |