批量为Runtime打资源标签 - BatchCreateCoreRuntimeTags

该接口用于批量为运行时打资源标签。

适用场景：

为运行时资源批量添加标签。

账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
agentarts::tagResource	Tagging	runtime	g:ResourceTag/<tag-key>	-	-
		runtimeEndpoint	g:ResourceTag/<tag-key>
		-	g:RequestTag/<tag-key> g:TagKeys

POST /v1/runtimes/{runtime_id}/tags/create

表1 路径参数
参数	是否必选	参数类型	描述
runtime_id	是	String	参数解释：运行时ID，用于唯一标识一个Agent运行时实例。可以通过AgentArts智能体运行时控制台或者运行时查询接口获取。约束限制: 不涉及。取值范围：匹配标准的UUID格式（8-4-4-4-12的十六进制数字串，由连字符分隔），符合正则条件^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$。默认取值: 不涉及。

表2 请求Body参数
参数	是否必选	参数类型	描述
tags	否	Array of CoreRunTagForPostTMS objects	参数解释: 标签键值对列表，用于为Runtime资源添加标签。约束限制: 不涉及。取值范围: 最小数量 0，最大数量 20 默认取值: 不涉及。

表3 CoreRunTagForPostTMS
参数	是否必选	参数类型	描述
key	是	String	参数解释: 标签键。约束限制: key不能为空或者空字符串，不能为空格。取值范围: 最大长度128个unicode字符，可用 UTF-8 格式表示的字母(包含中文、西班牙语、葡语等)、数字和空格，以及以下字符：_ . : / = + - 默认取值: 不涉及。
value	是	String	参数解释: 标签值。约束限制: 不涉及。取值范围: 每个值最大长度255个unicode字符，可用 UTF-8 格式表示的字母(包含中文、西班牙语、葡语等)、数字和空格，以及以下字符：_ . : / = + - @。默认取值: 不涉及。

状态码：204

No Content

状态码：400

表4 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。枚举值说明：AgentArts.03000400表示客户端请求参数错误。取值范围：固定值：AgentArts.03000400。
error_msg	String	参数解释：错误详细信息。取值范围：长度为1-512个字符。

状态码：401

表5 响应Body参数
参数	参数类型	描述
error_code	String	参数解释: 错误码。枚举值说明：AgentArts.03000401表示未授权（认证令牌缺失、无效或已过期）。取值范围: 不涉及。
error_msg	String	参数解释：错误详细信息。取值范围：长度为 1 - 512 个字符。

状态码：403

表6 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。枚举值说明：AgentArts.03000403表示禁止访问（认证后权限不足）。取值范围：固定值：AgentArts.03000403。
error_msg	String	参数解释：错误详细信息。取值范围：长度为 1 - 512 个字符。
coded_authorization_message	String	参数解释： IAM5 当OpenAPI无权限时报错信息。取值范围：长度为 1 - 1024 个字符。
details	Array of CoreRunErrorDetail objects	参数解释：依赖的下游服务错误信息列表。取值范围：最小数量 0，最大数量 10。

表7 CoreRunErrorDetail
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：长度为 18 个字符。
error_msg	String	参数解释：错误信息。取值范围：长度为 1 - 1024 个字符。

状态码：404

表8 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。枚举值说明：AgentArts.03000404表示资源不存在。取值范围：固定值：AgentArts.03000404。
error_msg	String	参数解释：错误详细信息。取值范围：长度为 1 - 512 个字符。

状态码：429

表9 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。枚举值说明：AgentArts.03000429表示请求过于频繁（触发限流）。取值范围：固定值：AgentArts.03000429。
error_msg	String	参数解释：错误详细信息。取值范围：长度为 1 - 512 个字符。

状态码：500

**表10** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。枚举值说明：AgentArts.03000500表示服务器内部错误。取值范围：固定值：AgentArts.03000500。
error_msg	String	参数解释：错误详细信息。取值范围：长度为 1 - 512 个字符。

创建单个标签

POST https://{Endpoint}/v1/runtimes/{runtime_id}/tags/create

{
  "tags" : [ {
    "key" : "appid",
    "value" : "testApp"
  } ]
}

无