文档首页/ 智能体身份/ API参考/ API/ 标签/ 向指定资源添加标签
更新时间:2026-11-04 GMT+08:00
分享

向指定资源添加标签

功能介绍

向指定资源添加标签。

URI

POST /v1/{resource_type}/{resource_id}/tags/create

表1 路径参数

参数

是否必选

参数类型

描述

resource_type

是

String

参数解释:

资源类型,用于指定要操作的资源类型。

约束限制:

不涉及。

取值范围:

  • oauth2CredentialProvider:OAuth2凭证提供商

  • apiKeyCredentialProvider:API Key凭证提供商

  • stsCredentialProvider:STS凭证提供商

  • tokenVault:令牌保管库

  • workloadIdentityDirectory:工作负载身份目录

  • workloadIdentity:工作负载身份

  • policyEngine:策略集

默认取值:

不涉及。

resource_id

是

String

参数解释:

资源ID,用于唯一标识一个资源。

约束限制:

不涉及。

取值范围:

只能由字母、数字、"-"和"_"组成,长度为1~64个字符。

默认取值:

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

tags

是

Array of Tag objects

参数解释:

自定义标签列表。

约束限制:

列表最少1个,最多20个标签。

取值范围:

不涉及。

默认取值:

不涉及。

表3 Tag

参数

是否必选

参数类型

描述

key

是

String

参数解释:

标签键,用于标识标签的名称。

约束限制:

首尾不能包含空格,不能以"_sys_"开头。

取值范围:

可以包含任意语种字母、数字、空格以及"_"、"."、":"、"/"、"="、"+"、"-"、"@"符号的任意组合,长度为1~128个字符。

默认取值:

不涉及。

value

是

String

参数解释:

标签值,用于标识标签的具体内容。

约束限制:

不涉及。

取值范围:

可以包含任意语种字母、数字、空格以及"_"、"."、":"、"/"、"="、"+"、"-"、"@"、"&"符号的任意组合,可以是空字符串,长度为0~255个字符。

默认取值:

不涉及。

响应参数

状态码:204

无

状态码:400

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

不涉及。

error_msg

String

参数解释:

错误信息。

取值范围:

不涉及。

request_id

String

参数解释:

请求ID。

取值范围:

不涉及。

encoded_authorization_message

String

参数解释:

加密后的认证失败信息,可以通过STS5解密接口进行解密。

取值范围:

不涉及。

状态码:403

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

不涉及。

error_msg

String

参数解释:

错误信息。

取值范围:

不涉及。

request_id

String

参数解释:

请求ID。

取值范围:

不涉及。

encoded_authorization_message

String

参数解释:

加密后的认证失败信息,可以通过STS5解密接口进行解密。

取值范围:

不涉及。

状态码:404

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

不涉及。

error_msg

String

参数解释:

错误信息。

取值范围:

不涉及。

request_id

String

参数解释:

请求ID。

取值范围:

不涉及。

encoded_authorization_message

String

参数解释:

加密后的认证失败信息,可以通过STS5解密接口进行解密。

取值范围:

不涉及。

请求示例

向指定资源添加标签。

POST https://{endpoint}/v1/{resource_type}/{resource_id}/tags/create

{
  "tags" : [ {
    "key" : "environment",
    "value" : "production"
  }, {
    "key" : "team",
    "value" : "platform"
  } ]
}

响应示例

无

状态码

状态码

描述

204

请求成功。

400

请求体异常。

403

没有操作权限。

404

未找到相应的资源。

错误码

请参见错误码。

相关文档