功能说明

GetBucketTagging接口用于获取指定Bucket的标签。该操作需要s3:GetBucketTagging权限，桶的拥有者默认具有该权限。

注意事项

通过API设置桶标签和通过控制台设置桶标签是完全不同的两套标签功能，二者不互通，故通过API获取桶标签只能获取通过API或SDK设置的桶标签，无法获取通过控制台设置的桶标签。

请求消息样式

GET /{Bucket}?tagging HTTP/1.1
Host: xxxx.zos.ctyun.cn
X-Amz-Content-SHA256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
Authorization: string
X-Amz-Date: 20220408T030447Z

请求消息参数

请求消息头

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

请求消息元素

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

响应消息样式

HTTP/1.1 Status Code
x-amz-request-id: tx000000000000000000004-00624fa64f-2a818-nanjing3
Content-Type: application/xml
Content-Length: 169
Date: Fri, 08 Apr 2022 03:04:47 GMT
Connection: Keep-Alive

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

响应消息头

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

响应消息元素

表 Tagging

表 TagSet

表 Tag

错误码

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