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 qn6qrrqxo2oawuk53otf****:ceOEyZavKY4QcjoUWYSpYbJ3****
-
返回示例
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> <Key>testa</Key> <Value>value1-test</Value> <Key>testb</Key> <Value>value2-test</Value> </TagSet> </Tagging>
SDK
此接口所对应的各语言SDK如下:
错误码
错误码 |
HTTP状态码 |
描述 |
NoSuchBucket |
404 |
目标Bucket不存在。 |
AccessDenied |
403 |
没有查看Bucket标签的权限。只有Bucket的拥有者及授权子账户才能查看Bucket的标签信息。 |