GetBucketTags用於擷取儲存空間(Bucket)的標籤資訊。
請求文法
GET /?tagging
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
響應元素
名稱 | 類型 | 描述 |
Tagging | 容器 | 儲存Bucket Tag結果的容器。 父元素:無 說明 如果源Bucket未設定Tag,OSS仍返回一個XML訊息體,但其中的Tagging元素為空白。 |
TagSet | 容器 | 儲存Bucket Tag結果的容器。 父元素:Tagging |
Tag | 容器 | 儲存Bucket Tag結果的容器。 父元素:TagSet |
Key | 字串 | 某個Tag的Key。 父元素:Tag |
Value | 字串 | 某個Tag的Value。 父元素:Tag |
樣本
請求樣本
GET /?tagging Host: oss-example.oss-cn-hangzhou.aliyuncs.com Date: Tue, 20 Dec 2018 13:09:13 GMT Authorization: OSS qn6q**************:77Dv****************
返回樣本
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>
SDK
此介面所對應的各語言SDK如下:
錯誤碼
錯誤碼 | HTTP狀態代碼 | 描述 |
NoSuchBucket | 404 | 目標Bucket不存在。 |
AccessDenied | 403 | 沒有查看Bucket標籤的許可權。只有Bucket的擁有者及授權子賬戶才能查看Bucket的標籤資訊。 |