GET Object Tagging
最近更新时间：2023-03-01 17:03:56
可通过GetObjectTagging接口获取对象（Object）的标签（Tagging）信息。
权限
使用此接口，必须是Bucket的所有者或具有ks3:GetObjectTagging权限。KS3将根据您是否拥有读权限返回相应信息。
请求语法
GET /<ObjectKey>?tagging HTTP 1.1
Host:<BucketName>.<Region>.ksyuncs.com
Date: GMT Date
Authorization: Auth String
请求头
此接口仅涉及公共请求头
响应头
此接口仅涉及公共响应头。
响应元素
| 名称 | 类型 | 描述 |
|---|---|---|
| Tagging | 容器 | 标签集合。 子节点：TagSet |
| TagSet | 容器 | 标签集合。 父节点：Tagging 子节点：Tag |
| Tag | 容器 | 标签集合。 父节点：TagSet 子节点：Key、Value |
| Key | 字符串 | 标签键。 父节点：Tag 子节点：无 |
| Value | 字符串 | 标签值。 父节点：Tag 子节点：无 |
特殊错误
不返回任何特殊错误。
示例
- 请求示例
GET /my-image.jpg ?tagging HTTP 1.1
Host:ks3-example.ks3-cn-beijing.ksyun.com
Date: Fri, 19 Jan 2020 11:40:22 GMT
Authorization: authorization string
- 返回示例
HTTP/1.1 200 OK
Date: Fri, 19 Jan 2020 11:40:22 GMT
Content-Type: application/xml
Connection: keep-alive
x-kss-request-id: f87dgt80hfsobs784dib5no5lkaqhf4n
Server: KS3
<Tagging>
<TagSet>
<Tag>
<Key>age</Key>
<Value>18</Value>
</Tag>
<Tag>
<Key>name</Key>
<Value>xiaoming</Value>
</Tag>
</TagSet>
</Tagging>
错误码
| 错误码 | HTTP状态码 | 描述 |
|---|---|---|
| AccessDenied | 403 | 不具有ks3:GetObjectTagging权限。 |
文档内容是否对您有帮助？
根本没帮助
文档较差
文档一般
文档不错
文档很好
在文档使用中是否遇到以下问题
内容不全，不深入
内容更新不及时
描述不清晰，比较混乱
系统或功能太复杂，缺乏足够的引导
内容冗长
更多建议
0/200
评价建议不能为空
提交成功！
非常感谢您的反馈，我们会继续努力做到更好！