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

对象存储

复制全文
下载 pdf
标签与存储容量配额
PutObjectSetTagging
复制全文
下载 pdf
PutObjectSetTagging
功能描述​
此接口用于覆盖写入指定 ObjectSet 的标签集合。​
注意事项​
通过子账号使用时,需要授予当前桶的 PutObjectSetTagging 权限。​
请求消息样式​
​
PUT /?objectsettagging HTTP/1.1​
Host: bucket-name.tos-cn-beijing.volces.com​
Date: GMT Date​
Authorization: authorization string​
​
请求参数和消息头​
该请求使用的公共请求消息头,请参见公共参数。​
请求元素​
​
名称​
参数类型​
是否必选​
示例值​
说明​
ObjectSetName​
String​
是​
"a/b/c/"​
本次配置标签的 ObjectSet 名称。​
说明​
  • 长度限制为 3 ~ 256 个字符。​
  • 如果 Bucket 配置了 PathLevel,则 ObjectSetName 的层级数必须与 Bucket 的配置保持一致。​
  • 不允许以自定义分隔符开头。​
TagSet​
Object​
否​
-​
ObjectSet 标签集合信息。​
Tags​
Array​
否​
-​
ObjectSet 标签列表信息。​
说明​
  • 每个 ObjectSet 最多可添加 10 个标签​
  • Key 和 Value 均区分大小写,合法字符集包括大小写字母、数字、空格和特殊符号 _ 、.、 : 、/、 =、 +、 -。​
Key​
String​
否​
owner​
标签 Key 的值。​
说明​
  • 同一 ObjectSet 的 Key 不能重复。​
  • Key 的长度不超过 128 个字符。​
Value​
String​
是​
zhangsan​
标签 Value 的值,长度不超过 256 个字符。​
​
响应消息头​
该请求返回的公共响应消息头,请参见公共参数。​
响应元素​
该请求响应中无消息元素。​
请求示例​
​
PUT /?objectsettagging HTTP/1.1​
Host: bucket-name.tos-cn-beijing.volces.com​
Date: GMT Date​
Authorization: authorization string​
{​
"ObjectSetName": "a/b/c",​
"TagSet": {​
"Tags": [{​
"Key": "key1",​
"Value": "value1"​
}, {​
"Key": "key2",​
"Value": "value2"​
}]​
}​
}​
​
响应示例​
​
HTTP/1.1 204 No Content​
​
最近更新时间:2026.05.21 16:23:29
这个页面对您有帮助吗?
有用
有用
无用
无用