## 功能描述此接口用于为存储桶设置桶标签。通过设置桶标签，您可以对Bucket进行分类管理。例如您可以在桶上添加部分费用标签，之后该桶产生的计费账单中都包含这些标签，从而可以针对明细账单做分类筛选，进行更详细的成本分析。 ## 注意事项只有存储桶的拥有者以及拥有 PutBucketTagging 权限的用户才能创建桶标签。 ## 标签设置规则 |**类别** |**说明** | |---|---| |标签键 |* 支持任何语言字母或文字（如中文、英文字母等）、数字、空格；支持特殊字符：`_.:/=+-@`。|\ | |* `volc:` 和`sys:`为系统预留的标签键，添加标签时，标签键的开头不能设置为任何大小写形式的 `volc:`和`sys:`。|\ | |* 标签键的长度需为 1~128 个字符。 | |标签值 |* 支持任何语言字母或文字（如中文、英文字母等）、数字、空格；支持特殊字符：`_.:/=+-@`。|\ | |* 标签值的长度需为 0~256 个字符，即标签值可以为空。 | |标签数量 |* 标签总数量无限制，但每个存储桶最多可绑定 50 个标签。 | ## 请求消息样式 ```JSON PUT /?tagging HTTP/1.1 Host: bucketname.tos-cn-beijing.volces.com Date: GMT Date Content-MD5: OolRtfRnEQlFUQVcEd5Q**** Content-Length: 262 Authorization: authorization string { "TagSet": { "Tags": [{ "Key": "key1", "Value": "value1" }, { "Key": "key2", "Value": "value2" }] } } ``` ## 请求参数和消息头该请求需要在消息头中设置请求元素的 Content\-MD5 值，与上传的请求元素的 MD5 值进行比较，如果不相等，将返回错误。其他使用的公共请求消息头，请参见[公共参数](/docs/6349/75044)。 |**名称** |**位置** |**参数类型** |**是否必选** |**示例值** |**说明** | |---|---|---|---|---|---| |tagging |Query |String |是 |\- |代表 PutBucketTagging 请求的特殊标识。 | ## 请求元素 |**名称** |**参数类型** |**是否必选** |**示例值** |**说明** | |---|---|---|---|---| |TagSet |Object |是 |\- |桶标签集合信息。 | |Tags |Array |是 |\- |桶标签列表信息。 | |Key |String |是 |owner |标签 Key 的值。具体设置规则，请参见[设置桶标签](/docs/6349/147062)。 | |Value |String |是 |zhangsan |标签 Value 的值。具体设置规则，请参见[设置桶标签](/docs/6349/147062)。 | ## 响应消息头该请求返回的公共响应消息头，请参见[公共参数](/docs/6349/75044)。 ## 响应元素该请求响应中无消息元素。 ## **请求示例** ```JSON PUT /?tagging HTTP/1.1 Host: bucketname.tos-cn-beijing.volces.com Date: GMT Date Content-MD5: ContentMD5 Authorization: authorization string { "TagSet": { "Tags": [{ "Key": "key1", "Value": "value1" }, { "Key": "key2", "Value": "value2" }] } } ``` ## 响应示例 ```JSON HTTP/1.1 200 OK Date: Sat, 07 Oct 2023 09:02:23 GMT Server: TosServer x-tos-id-2: 1e89f203jld00006-a444fd0 x-tos-request-id: 1e89f203b2d00006-a444ed0 Content-Length: 0 ```

对象存储