GetObjectTagging

版本控制

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

响应元素

示例

• 未开启版本控制

  在未开启版本控制的情况下，针对存储空间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示例如下：

• Java

• Python

• Go V2

• PHP

• C++

• .NET

• Node.js

• iOS

命令行工具ossutil

GetObjectTagging接口所对应的ossutil命令，请参见get-object-tagging。