更新时间:2023-04-24 GMT+08:00
分享

批量添加节点标签

功能介绍

专业版HiLens控制台标签管理,用户选择多个设备,批量添加多个标签。

URI

POST /v3/{project_id}/tag-mgr/node-tags

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。获取方法请参见获取项目ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

租户Token。获取方法请参见获取Token

表3 请求Body参数

参数

是否必选

参数类型

描述

resources

Array of NodeResource objects

资源列表

tags

Array of NodeTag objects

标签列表

表4 NodeResource

参数

是否必选

参数类型

描述

resource_id

String

资源ID

resource_type

String

资源类型

表5 NodeTag

参数

是否必选

参数类型

描述

key

String

标签键,最大长度36个字符。不能为空,只能包含大小写字母,数字,中划线“-”,下划线“_”

value

String

标签值,每个值最大长度43个字符,删除时如果value有值按照key/value删除,如果value没值,则按照key删除。不能为空,只能包含大小写字母,数字,中划线“-”,下划线“_”

响应参数

请求示例

针对多个设备批量添加多个标签

POST https://{endpoint}/v3/{project_id}/tag-mgr/node-tags

{
  "resources" : [ {
    "resource_type" : "node",
    "resource_id" : "hilens-989c34eeaeda4a5380b7d9f2b101f7f1"
  }, {
    "resource_type" : "node",
    "resource_id" : "hilens-3f665c35ea3b471880c1499e05a3c630"
  } ],
  "tags" : [ {
    "key" : "k1",
    "value" : "v1"
  } ]
}

响应示例

状态码

状态码

描述

200

请求成功

401

认证不通过

403

拒绝执行请求

404

请求的资源不存在

500

服务器内部错误

错误码

请参见错误码

相关文档