调用GetBucketTags获取Bucket的标签信息_对象存储(OSS)-阿里云帮助中心

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的标签信息。