Get Object Tagging

最近更新时间:2021-04-07 20:11:41

查看PDF

可通过GetObjectTagging接口获取对象(Object)的标签(Tagging)信息。

权限

该接口操作需要用户对Object拥有GetObjectTagging权限。KS3将根据你是否拥有写权限返回相应信息。
如果你并不拥有该Object的GetObjectTagging权限,KS3将会返回的 HTTP 状态码为403(access denied)错误。

请求语法

GET /<ObjectKey>?tagging HTTP 1.1
Host:<BucketName>.<Region>.ksyun.com
Date: GMT Date
Authorization: Auth String

请求头

此接口仅涉及公共请求头

响应头

此接口仅涉及公共响应头。

响应元素

名称 类型 描述
Tagging 容器 标签集合。 子节点:TagSet
TagSet 容器 标签集合。 父节点:Tagging 子节点:Tag
Tag 容器 标签集合。 父节点:TagSet 子节点:Key、Value
Key 字符串 标签键。 父节点:Tag 子节点:无
Value 字符串 标签值。 父节点:Tag 子节点:无

特殊错误

不返回任何特殊错误。

示例

  • 请求示例
GET /<ObjectKey>?tagging HTTP 1.1
Host:<BucketName>.<Region>.ksyun.com
Date: GMT Date
Authorization: Auth String 
返回示例
   
HTTP/1.1 200 OK
Content-Type: application/xml
Connection: close
Date: Fri, 19 Jan 2020 11:40:22 GMT
Server: ks3
<Tagging>
    <TagSet>
        <Tag>
            <Key>age</Key>
            <Value>18</Value>
        </Tag>
        <Tag>
            <Key>name</Key>
            <Value>xiaoming</Value>
        </Tag>
    </TagSet>
</Tagging>

文档内容是否对您有帮助?

根本没帮助
文档较差
文档一般
文档不错
文档很好

在文档使用中是否遇到以下问题

  • 内容不全,不深入
  • 内容更新不及时
  • 描述不清晰,比较混乱
  • 系统或功能太复杂,缺乏足够的引导
  • 内容冗长

更多建议

0/200

评价建议不能为空

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

问题反馈