调用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

请求头

此接口仅包含公共请求头。关于公共请求头的更多信息，请参见公共请求头（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 qn6qrrqxo2oawuk53otf****:kZoYNv66bsmc10+dcGKw5x2P****
    返回示例 
    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 ************:********************
    返回示例 
    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示例如下：