金山云-文档中心-GET Object Tagging

对象存储(KS3)

查看更多结果

未找到含当前关键字的文档标题

页面目录

全部展开全部收起

产品更新动态

未找到含该关键词的产品

文档中心

对象存储(KS3)

API文档

Object相关

对象标签（Tagging）

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权限。

文档导读

上一篇：PUT Object Tagging

下一篇：DELETE Object Tagging

纯净模式常规模式

纯净模式

点击可全屏预览文档内容