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: 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如下：
Java
Python
Go V2
C++
Node.js
命令行工具ossutil
GetBucketTags接口所对应的ossutil命令，请参见get-bucket-tags。
错误码
错误码 | HTTP状态码 | 描述 |
NoSuchBucket | 404 | 目标Bucket不存在。 |
AccessDenied | 403 | 没有查看Bucket标签的权限。只有Bucket的拥有者及授权子账户才能查看Bucket的标签信息。 |