調用GetBucketTags擷取Bucket的標籤資訊 - Object Storage Service

GetBucketTags用於擷取儲存空間（Bucket）的標籤資訊。

注意事項

如需調用GetBucketTags擷取Bucket的標籤資訊，您必須擁有oss:GetBucketTagging許可權。具體操作，請參見為RAM使用者授予自訂的權限原則。

請求文法

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: Thu, 17 Apr 2025 13:09:13 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

返回樣本

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如下：

命令列工具ossutil

GetBucketTags介面所對應的ossutil命令，請參見get-bucket-tags。

錯誤碼

錯誤碼	HTTP狀態代碼	描述
NoSuchBucket	404	目標Bucket不存在。
AccessDenied	403	沒有查看Bucket標籤的許可權。只有Bucket的擁有者及授權子賬戶才能查看Bucket的標籤資訊。