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