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

查询资源标签

功能介绍

查询资源标签

URI

GET /v1/{project_id}/{resource_type}/{node_id}/tags

表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

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

tags

Array of ResourceTag objects

资源标签列表

数组长度:0 - 1000

表4 ResourceTag

参数

参数类型

描述

key

String

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

最小长度:1

最大长度:128

value

String

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

最小长度:0

最大长度:255

状态码: 400

表5 响应Body参数

参数

参数类型

描述

code

String

状态码

最小长度:3

最大长度:3

error_code

String

错误码

最小长度:12

最大长度:12

error_msg

String

错误信息

最小长度:1

最大长度:65535

message

String

错误详细信息

最小长度:0

最大长度:65535

状态码: 401

表6 响应Body参数

参数

参数类型

描述

code

String

状态码

最小长度:3

最大长度:3

error_code

String

错误码

最小长度:12

最大长度:12

error_msg

String

错误信息

最小长度:1

最大长度:65535

message

String

错误详细信息

最小长度:0

最大长度:65535

状态码: 500

表7 响应Body参数

参数

参数类型

描述

code

String

状态码

最小长度:3

最大长度:3

error_code

String

错误码

最小长度:12

最大长度:12

error_msg

String

错误信息

最小长度:1

最大长度:65535

message

String

错误详细信息

最小长度:0

最大长度:65535

请求示例

响应示例

状态码: 200

请求成功

{
  "tags" : [ {
    "key" : "key1",
    "value" : "value1"
  }, {
    "key" : "key2",
    "value" : "value"
  } ]
}

状态码: 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"
}

状态码

状态码

描述

200

请求成功

400

请求参数校验不通过

401

鉴权失败

500

服务内部执行错误

错误码

请参见错误码