调用GetObjectTagging接口获取对象Object的标签Tagging信息

调用GetObjectTagging接口获取对象（Object）的标签（Tagging）信息。

版本控制

调用GetObjectTagging接口时，默认只能获取Object当前版本的标签信息。您可以通过指定versionId参数来获取指定Object版本的标签信息。如果Object的对应版本为删除标记（Delete Marker），则OSS将返回404 Not Found。

请求语法

GET /objectname?tagging
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 20 Mar 2019 02:02:36 GMT
Authorization: SignatureValue

当您在OSS ON云盒中调用该接口时，您需要将Host替换为云盒Endpoint。更多信息，请参见云盒Endpoint。

请求头

此接口仅涉及公共请求头。更多信息，请参见公共请求头（Common Request Headers）。

响应头

此接口仅涉及公共响应头。更多信息，请参见公共响应头（Common Response Headers）。

响应元素

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

示例

未开启版本控制

在未开启版本控制的情况下，针对存储空间bucketname中的对象objectname发起GET请求时，获取到{a:1}和{b:2}的标签信息。标签获取成功后返回200 (OK)。

请求示例

GET /objectname?tagging
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 20 Mar 2019 02:02:36 GMT
Authorization: OSS qn6q**************:77Dv****************

返回示例

200 (OK)
content‐length: 209
server: AliyunOSS
x‐oss‐request‐id: 5C919F38461FB4282600****
date: Wed, 20 Mar 2019 02:02:32 GMT
content‐type: application/xml

<?xml version="1.0" encoding="UTF‐8"?>
<Tagging>
  <TagSet>
    <Tag>
      <Key>a</Key>
      <Value>1</Value>
    </Tag>
    <Tag>
      <Key>b</Key>
      <Value>2</Value>
    </Tag>
  </TagSet>
</Tagging>

已启用版本控制

在启用版本控制的情况下，针对存储空间bucketname中的对象objectname的指定版本（即请求示例中的versionId）发起GET请求时，获取到{age:18}的标签信息。标签获取成功后返回200 (OK)。

请求示例

GET /objectname?tagging&versionId=CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0****
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 24 Jun 2020 08:50:28 GMT
Authorization: OSS qn6q**************:77Dv****************

返回示例

200 (OK)
content-length: 161
server: AliyunOSS
x-oss-request-id: 5EF313D44506783438F3****
date: Wed, 24 Jun 2020 08:50:28 GMT
content-type: application/xml
x-oss-version-id: CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0****

<?xml version="1.0" encoding="UTF-8"?>
<Tagging>
  <TagSet>
    <Tag>
      <Key>age</Key>
      <Value>18</Value>
    </Tag>
  </TagSet>
</Tagging>

SDK

GetObjectTagging接口对应的各语言SDK示例如下：