功能说明

GetObjectTagging返回对象的标签集。

注意事项

要使用此操作，您必须具有执行s3:GetObjectTagging操作的权限。默认情况下，操作返回有关对象当前版本的信息。对于多版本的存储桶，您的存储桶中可以有一个对象的多个版本。此时，要检索任何其他版本的标签，请使用versionId查询参数。同时，您还需要s3:GetObjectVersionTagging操作的权限。默认情况下，存储桶拥有者具有此权限，并且可以将此权限授予其他人。

请求消息样式

GET /{Bucket}/{Key}?tagging&versionId={VersionId} HTTP/1.1
Host: xxx.zos.ctyun.cn
Accept-Encoding: identity
Date: Tue, 12 Apr 2022 11:03:15 GMT
Authorization: string

请求消息参数

请求消息头

该请求使用公共的请求消息头，请参见如何调用API-构造请求-请求消息头。

请求消息元素

该请求消息中不带消息元素。

响应消息样式

HTTP/1.1 Status Code
x-amz-request-id: tx00000000000000000001b-0062555c74-34455-default
Content-Type: application/xml
Content-Length: 169
Date: Tue, 12 Apr 2022 11:03:16 GMT
Connection: Keep-Alive

<?xml version="1.0" encoding="UTF-8"?>
<Tagging xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <TagSet>
    <Tag>
      <Key>tagKey</Key>
      <Value>tagValue</Value>
    </Tag>
  </TagSet>
</Tagging>

响应消息头

该请求的响应消息使用公共的响应消息头，请参见如何调用API-响应结果-响应消息头。

响应消息元素

该响应中将标签信息以消息元素的形式返回，元素的具体含义如下表所示：

表Tagging

表TagSet

表Tag

错误码

请参见调用前必知-错误码-全局错误码。