You need to enable JavaScript to run this app.
导航
对象存储
  • 文档首页
    • /
  • 对象存储

PutBucketTagging

最近更新时间：2023.11.21 10:22:23

首次发布时间：2023.11.21 10:22:23

我的收藏

功能描述

此接口用于为存储桶设置桶标签。通过设置桶标签，您可以对Bucket进行分类管理。例如您可以在桶上添加部分费用标签，之后该桶产生的计费账单中都包含这些标签，从而可以针对明细账单做分类筛选，进行更详细的成本分析。

注意事项

只有存储桶的拥有者以及拥有 PutBucketTagging 权限的用户才能创建桶标签。

标签设置规则

类别

说明

标签键

  • 支持任何语言字母或文字（如中文、英文字母等）、数字、空格；支持特殊字符：_.:/=+-@。
  • volc: 为系统预留的标签键，添加标签时，标签键的开头不能设置为任何大小写形式的 volc:。
  • 标签键的长度需为 1~128 个字符。

标签值

  • 支持任何语言字母或文字（如中文、英文字母等）、数字、空格；支持特殊字符：_.:/=+-@。
  • 标签值的长度需为 0~256 个字符，即标签值可以为空。

标签数量

  • 标签总数量无限制，但每个存储桶最多可绑定 50 个标签。

请求消息样式

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 值进行比较，如果不相等，将返回错误。其他使用的公共请求消息头，请参见公共参数。

名称

位置

参数类型

是否必选

示例值

说明

tagging

Query

String

是

-

代表 PutBucketTagging 请求的特殊标识。

请求元素

名称

参数类型

是否必选

示例值

说明

TagSet

Object

是

-

桶标签集合信息。

Tags

Array

是

-

桶标签列表信息。

Key

String

是

owner

标签 Key 的值。具体设置规则，请参见设置桶标签。

Value

String

是

zhangsan

标签 Value 的值。具体设置规则，请参见设置桶标签。

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

响应元素

该请求响应中无消息元素。

请求示例

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"
                }]
        }
}

响应示例

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