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的標簽信息。 |
文檔內容是否對您有幫助?