Anda dapat memanggil operasi ini untuk menanyakan tag yang dikonfigurasi untuk sebuah bucket.
Sintaks permintaan
GET /? tagging
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueCatatan
Izin oss:GetBucketTagging diperlukan untuk mendapatkan informasi penandaan bucket dengan memanggil operasi GetBucketTags. Untuk informasi lebih lanjut, lihat Lampirkan kebijakan kustom ke pengguna RAM.
Elemen respons
Elemen | Tipe | Deskripsi |
Tagging | Container | Kontainer yang menyimpan tag yang dikembalikan dari bucket. Node induk: Tidak ada Catatan Jika tidak ada tag yang dikonfigurasi untuk bucket, pesan XML akan dikembalikan di mana elemen Tagging kosong. |
TagSet | Container | Kontainer yang menyimpan tag yang dikembalikan dari bucket. Node induk: Tidak ada |
Tag | Container | Kontainer yang menyimpan tag yang dikembalikan dari bucket. Node induk: TagSet |
Key | String | Kunci untuk sebuah tag. Node induk: Tag |
Value | String | Nilai dari sebuah tag. Node induk: Tag |
Contoh
Permintaan Contoh
GET /? tagging Host: oss-example.oss-cn-hangzhou.aliyuncs.com Date: Tue, 20 Dec 2018 13:09:13 GMT Authorization: OSS qn6q**************:77Dv****************Respons Contoh
200 (OK) content-length: 237 server: AliyunOSS x-oss-request-id: 5C1B2D24B90AD5490CFE368E date: Thu, 20 Dec 2018 13:12:21 GMT content-type: application/xml <? xml version="1.0" encoding="UTF-8"? > <Tagging> <TagSet> <Tag> <Key>testa</Key> <Value>value1-test</Value> </Tag> <Tag> <Key>testb</Key> <Value>value2-test</Value> </Tag> </TagSet> </Tagging>
OSS SDKs
Anda dapat menggunakan OSS SDK berikut untuk operasi GetBucketTags:
ossutil
Untuk informasi tentang perintah ossutil yang sesuai dengan operasi GetBucketTags, lihat get-bucket-tags.
Kode kesalahan
Kode kesalahan | Status HTTP | Deskripsi |
NoSuchBucket | 404 | Pesan kesalahan yang dikembalikan karena bucket yang ditentukan tidak ada. |
AccessDenied | 403 | Pesan kesalahan yang dikembalikan karena Anda tidak memiliki izin untuk menanyakan tag yang dikonfigurasi untuk bucket. Hanya pemilik bucket yang dapat menanyakan tag yang dikonfigurasi untuk sebuah bucket. |