## 功能描述将一个或多个用户定义的标签应用于 TRN 资源或更新现有标签。每个标签都是由键和值对组成的标签。标签可以帮助您组织资源、跟踪资源成本并控制对资源的访问。 ## 注意事项 * 您最多可以为每个资源添加 50 个标签。 * Resource TRN 最大长度不能超过 1011。 * 当前资源仅支持 Vector Bucket。 ## 请求消息样式 ```Plain Text POST /tags/resourceTrn HTTP/1.1 Host: tosvectors-cn-beijing.volces.com Content-type: application/json Authorization: authorization string Date: Mon, 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 个标签。

* 您可以为每个存储桶添加多个不同类别的标签，但同一存储桶下多个标签的标签键不可重复，且每个标签键只能有一个标签值。

* 不同地域之间的标签信息不互通。例如在华北2（北京）地域创建的标签在华东2（上海）地域不可见。 | ## 响应消息头返回公共的响应头，请参见[公共参数](https://www.volcengine.com/docs/6349/2143220)。 ## 响应元素如果操作成功，服务将返回一个 HTTP 200 响应且响应元素为空。如果操作失败，返回[响应码](https://www.volcengine.com/docs/6349/2143221)中定义的错误码。 ## 请求示例 ```SQL 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: Mon, 10 Dec 2025 12:49:14 GMT { "tags": { "string" : "string" } } ``` ## 响应示例 ```SQL HTTP/1.1 200 OK x-tos-id-2: 797014003c90a9b694003c9-b15a995-1vV80n-CVB-cb-tos-1az-front-azd-vectors-2 x-tos-request-id: 797014003c90a9b694003c9-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 ```

对象存储