功能说明

PutBucketTagging接口用于为指定的Bucket设置标签。一个Bucket最多设置50个标签。该操作需要s3:PutBucketTagging权限，桶的所有者默认拥有该权限。该操作会覆盖原有标签。

注意事项

通过API设置桶标签和通过控制台设置桶标签是完全不同的两套标签功能，二者不互通，但可同时设置。

请求消息样式

PUT /{Bucket}?tagging HTTP/1.1
Host: xxxx.zos.ctyun.cn
X-Amz-Content-SHA256: f2e4b7dea8317ddfd41909a9b637cc3794d2d35292f83dfc290ece5b921b9a35
Content-Length: 131
Content-MD5: 5ylcKDgOC30HICvXy5HnHw==
X-Amz-Date: 20220408T015258Z
Authorization: string

<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

响应消息样式

HTTP/1.1 Status Code
x-amz-request-id: tx000000000000000000002-00624f957a-2a818-nanjing3
Content-Type: application/xml
Content-Length: 0
Date: Fri, 08 Apr 2022 01:52:58 GMT
Connection: Keep-Alive

响应消息头

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

响应消息元素

该请求的响应中不带有响应元素。

错误码

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