You need to enable JavaScript to run this app.
文档中心
对象存储

对象存储

请输入
  • 文档首页
    • 对象存储API 参考存储桶桶标签PutBucketTagging
复制全文
下载 pdf
我的收藏
桶标签
PutBucketTagging
复制全文
下载 pdf
我的收藏
PutBucketTagging
功能描述​
此接口用于为存储桶设置桶标签。通过设置桶标签，您可以对Bucket进行分类管理。例如您可以在桶上添加部分费用标签，之后该桶产生的计费账单中都包含这些标签，从而可以针对明细账单做分类筛选，进行更详细的成本分析。​
注意事项​
只有存储桶的拥有者以及拥有 PutBucketTagging 权限的用户才能创建桶标签。​
标签设置规则​
​
类别​
说明​
标签键​
  • 支持任何语言字母或文字（如中文、英文字母等）、数字、空格；支持特殊字符：_.:/=+-@。​
  • volc: 和sys:为系统预留的标签键，添加标签时，标签键的开头不能设置为任何大小写形式的 volc:和sys:。​
  • 标签键的长度需为 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​
​
​
最近更新时间：2025.12.18 17:24:09
这个页面对您有帮助吗？
有用
有用
无用
无用