GetBucketTags - - 阿里雲

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的標籤資訊。