文档首页/ 安全云脑 SecMaster/ API参考/ 安全云脑API（不包含安全分析V2）/ 资源标签管理/ 批量添加资源标签 - BatchTagResources
更新时间：2025-10-28 GMT+08:00
在线调试
CLI示例
查看PDF
分享

批量添加资源标签 - BatchTagResources

功能介绍

为指定实例批量添加标签

标签管理服务需要使用该接口批量管理实例的标签。

一个资源上最多有20个标签。

调用方法

请参见如何调用API。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

resource_type

是

String

资源类型

resource_id

是

String

资源ID

project_id

是

String

参数解释：

项目ID，用于明确项目归属，配置后可通过该ID查询项目下资产，可以通过调用API获取，也可以从控制台获取。获取项目ID

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-type

是

String

参数解释：

内容类型

  • application/json;charset=UTF-8 普通API请求的类型

约束限制：

不涉及

取值范围：

  • application/json;charset=UTF-8

默认取值：

不涉及

X-Auth-Token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。
表3 请求Body参数

参数

是否必选

参数类型

描述

tags

否

Array of ResourceTag objects

标签列表

租户权限时该字段必选，op_service权限时和sys_tags二选一

sys_tags

否

Array of ResourceTag objects

系统标签列表

op_service权限可以访问，和tags二选一。

目前TMS调用时只包含一个resource_tag结构体 ，key固定为：_sys_enterprise_project_id

value是UUID或0,value为0表示默认企业项目。现在仅支持create操作
表4 ResourceTag

参数

是否必选

参数类型

描述

key

是

String

键。最大长度128个unicode字符。

key符合3.1 KEY字符集规范

value

是

String

值。每个值最大长度255个unicode字符。

value符合3.2 VALUE字符集规范。

响应参数

状态码：204

No Content

状态码：400

表5 响应Body参数

参数

参数类型

描述

error_code

String

Error code.

error_msg

String

Error description.

状态码：401

表6 响应Body参数

参数

参数类型

描述

error_code

String

Error code.

error_msg

String

Error description.

状态码：403

表7 响应Body参数

参数

参数类型

描述

error_code

String

Error code.

error_msg

String

Error description.

状态码：404

表8 响应Body参数

参数

参数类型

描述

error_code

String

Error code.

error_msg

String

Error description.

状态码：500

表9 响应Body参数

参数

参数类型

描述

error_code

String

Error code.

error_msg

String

Error description.

请求示例

  • 更改普通租户tag

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

{
  "action" : "create",
  "tags" : [ {
    "key" : "key1",
    "value" : "value1"
  }, {
    "key" : "key",
    "value" : "value3"
  } ]
}

  • 更改系统标签

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

{
  "action" : "create",
  "sys_tags" : [ {
    "key" : "_sys_enterprise_project_id",
    "value" : "5aa119a8-d25b-45a7-8d1b-88e127885635"
  } ]
}

响应示例

无

状态码

状态码

描述

204

No Content

400

标签等参数非法

401

鉴权失败

403

权限不足

404

资源未找到

500

系统异常

错误码

请参见错误码。

父主题： 资源标签管理