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

对象存储

复制全文
下载 pdf
向量桶
TagResource
复制全文
下载 pdf
TagResource
功能描述​
为 TRN 标识的资源添加或更新一个或多个用户自定义标签。每个标签由一个键值对组成。标签可以帮助您组织资源、跟踪资源成本并控制对资源的访问。​
注意事项​
  • 您最多可以为每个资源添加 50 个标签。​
  • Resource TRN 最大长度不能超过 1011 个字符。​
  • 目前仅支持为向量桶资源添加标签​
请求消息样式​
​
POST /tags/resourceTrn HTTP/1.1​
Host: tosvectors-cn-beijing.volces.com​
Content-type: application/json​
Authorization: authorization string​
Date: Wed, 10 Dec 2025 12:49:14 GMT​
{​
"tags": { ​
"string" : "string" ​
}​
}​
​
请求参数和消息头​
无。​
请求元素​
​
名称​
参数类型​
是否必选​
示例值​
说明​
tags​
map​
​
是​
{​
"key1": "value2"​
}​
标签键:​
  • 支持 UTF-8 格式表示的字符、空格、数字,以及特殊字符 _.:/=+-@。​
  • 标签键的长度为 1~128 个字符。​
  • 标签键区分大小写,如 Type 和 type 是两个不同的标签键。​
  • volc: 为系统预留的标签键,添加标签时,标签键的开头不能设置为任何大小写形式的 volc:。​
  • sys: 为系统预留的标签键,添加标签时,标签键的开头不能设置为任何大小写形式的 sys:。​
标签值:​
  • 支持 UTF-8 格式表示的字符、空格、数字,以及特殊字符 _.:/=+-@。​
  • 标签值区分大小写,如 Standard 和 standard 是两个不同的标签值。​
  • 标签键的长度为 0~256 个字符,即标签值可以为空。​
其他约束:​
  • 标签总数量无限制,但每个向量桶最多可绑定 50 个标签。​
  • 您可以为每个向量桶添加多个不同类别的标签,但同一向量桶下多个标签的标签键不可重复,且每个标签键只能有一个标签值。​
​
响应消息头​
返回公共的响应头,请参见公共参数。​
响应元素​
如果操作成功,服务将返回一个 HTTP 200 响应且响应元素为空。​
如果操作失败,返回响应码中定义的错误码。​
请求示例​
​
POST tags/trn:tosvectors:test-region:test-account:bucket/test-bkt HTTP/1.1​
Host: tosvectors-cn-beijing.volces.com​
Content-type: application/json​
Authorization: authorization string​
Date: Wed, 10 Dec 2025 12:49:14 GMT​
{​
"tags": { ​
"string" : "string" ​
}​
}​
​
响应示例​
​
HTTP/1.1 200 OK​
x-tos-id-2: 797014003c90a9b6940****-b15a995-1vV80n-CVB-cb-tos-1az-front-azd-vectors-2​
x-tos-request-id: 797014003c90a9b6940****-b15a995-1vV80n-CVB-cb-tos-1az-front-azd-vectors-2​
x-tos-server-time: 123​
Date: Fri, 27 Mar 2026 10:02:13 GMT​
Server: TosServer​
Content-Length: 0​
​
最近更新时间:2026.09.18 14:23:39
这个页面对您有帮助吗?
有用
有用
无用
无用