更新时间:2024-01-31 GMT+08:00

批量添加资源标签

功能介绍

批量添加资源标签

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

最小长度:32

最大长度:32

resource_type

String

资源类型

最小长度:4

最大长度:32

node_id

String

节点ID

最小长度:36

最大长度:45

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token

最小长度:1

最大长度:65535

表3 请求Body参数

参数

是否必选

参数类型

描述

tags

Array of ResourceTag objects

标签列表。租户权限时该字段必选,op_service权限时和sys_tags二选一。

数组长度:0 - 1000

sys_tags

Array of ResourceSysTag objects

系统标签列表。op_service权限可以访问,和tags二选一。

数组长度:0 - 1000

表4 ResourceTag

参数

是否必选

参数类型

描述

key

String

键。最大长度128个字符,可以包含任意语种字母, 数字,空格和_ . : = + - @,但首尾不能含有空格, 不能以_sys_开头。

最小长度:1

最大长度:128

value

String

值。每个值最大长度255个字符,可以包含任意语种字母, 数字,空格和_.:/=+-@。

最小长度:0

最大长度:255

表5 ResourceSysTag

参数

是否必选

参数类型

描述

key

String

键。固定为:_sys_enterprise_project_id。

最小长度:1

最大长度:128

value

String

值。为企业项目ID值,值为0表示默认企业项目

最小长度:0

最大长度:255

响应参数

状态码: 400

表6 响应Body参数

参数

参数类型

描述

code

String

状态码

最小长度:3

最大长度:3

error_code

String

错误码

最小长度:12

最大长度:12

error_msg

String

错误信息

最小长度:1

最大长度:65535

message

String

错误详细信息

最小长度:0

最大长度:65535

状态码: 401

表7 响应Body参数

参数

参数类型

描述

code

String

状态码

最小长度:3

最大长度:3

error_code

String

错误码

最小长度:12

最大长度:12

error_msg

String

错误信息

最小长度:1

最大长度:65535

message

String

错误详细信息

最小长度:0

最大长度:65535

状态码: 500

表8 响应Body参数

参数

参数类型

描述

code

String

状态码

最小长度:3

最大长度:3

error_code

String

错误码

最小长度:12

最大长度:12

error_msg

String

错误信息

最小长度:1

最大长度:65535

message

String

错误详细信息

最小长度:0

最大长度:65535

请求示例

响应示例

状态码: 400

请求参数校验不通过

{
  "code" : 400,
  "error_code" : "BCS.03400001",
  "error_msg" : "Invalid request.",
  "message" : "unmarshal request data error"
}

状态码: 401

鉴权失败

{
  "code" : 401,
  "error_code" : "BCS.03401001",
  "error_msg" : "Authorization failed.",
  "message" : "request token is not valid"
}

状态码: 500

服务内部执行错误

{
  "code" : 500,
  "error_code" : "BCS.03500001",
  "error_msg" : "Internal error.",
  "message" : "project [xxx] node [xxx] get service bearer user token error"
}

状态码

状态码

描述

204

请求成功

400

请求参数校验不通过

401

鉴权失败

500

服务内部执行错误

错误码

请参见错误码