文档中心

AgentKit

请输入

Tag

TagResources - 添加用户标签

为一个或多个资源添加用户标签。

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：TagResources

要执行的操作，取值：TagResources。

Version string 必选示例值：2025-10-30

API的版本，取值：2025-10-30。

ResourceIds.N string[] 必选示例值：ResourceIds.1=i-l8u0p77yseabkpak****&ResourceIds.2=i-l8u0p7xyseabkbak****

资源ID。

参数 - N：表示资源的序号，取值范围：1～50。

多个资源之间用&分隔。

ResourceType string 必选示例值：memory

资源类型，取值：

runtime：智能体运行时。

tool：工具集。

memory: 记忆库。

mcpservice: MCP服务。

mcptoolset: MCP工具集。

Tags.N.Key string[] 必选示例值：Tags.1.Key=k1

为资源添加的用户标签的标签键。

参数 - N：表示标签键的序号，取值范围：1～20。

多个标签键之间用&分隔。

命名规则如下：

不能以任何大小写形式的volc:或sys:开头。

volc:或sys:开头为系统预留标签键禁止创建。

只能包含语言字符、数字、空格和英文符号“_”、“.”、“:”、“/”、“=”、“+”、“-”、“@”。

长度限制在1～128个字符之间。

Tags.N.Value string[] 可选示例值：Tags.1.Value=v1

为资源添加的用户标签的标签值。

参数 - N：表示标签值的序号，取值范围：1～20。

多个标签值之间用&分隔。

命名规则如下：

只能包含语言字符、数字、空格和英文符号“_”、“.”、“:”、“/”、“=”、“+”、“-”、“@”。

允许为空，长度限制在0～256个字符之间。

Tags.N.Type string[] 可选示例值：custom

标签类型。

system：系统标签。

custom：用户标签。

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

POST https://agentkit.cn-beijing.volcengineapi.com?Action=TagResources&Version=2025-10-30 HTTP/1.1​
Content-Type: application/json; charset=UTF-8​
{​
  "ResourceType": "sRywhOzLUe"​
}​

返回示例

{​
  "ResponseMetadata": {​
    "RequestId": "20251125162502098132110105524B2F",​
    "Action": "TagResources",​
    "Version": "2025-10-30",​
    "Service": "agentkit",​
    "Region": "cn-beijing"​
  },​
  "Result": {}​
}​

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	MissingParameter.Key	The required parameter Key is not supplied.	参数Key不能为空。
400	MissingParameter.ResourceIds	Resource Ids cannot be empty.	资源id不能为空。
400	MissingParameter.ResourceType	The required parameter ResourceType is not supplied.	参数ResourceType不能为空。
400	MissingParameter.Tags	The required parameter Tags is not supplied.	参数标签数量不能为空。
400	MissingParameter.Value	The required parameter Value is not supplied.	参数Value不能为空。
404	InvalidResource.NotFound	The specified resource does not exist.	资源不存在。
500	InternalError	An internal error has occurred.	内部错误。

最近更新时间：2026.02.14 11:21:12

这个页面对您有帮助吗？

有用

无用