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

查询某资源类型的标签

功能介绍

专业版HiLens控制台标签管理,查询某种资源类型的所有标签,返回标签列表。

URI

GET /v3/{project_id}/tag-mgr/{resource_type}/tags

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

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

resource_type

String

资源类型

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

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

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

tags

Array of ResourceTagObject objects

资源标签对列表

表4 ResourceTagObject

参数

参数类型

描述

resource_id

String

资源ID,不同资源(节点,部署,配置项,密钥)有不同的资源ID

key

String

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

value

String

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

请求示例

查询某种资源类型的所有标签

GET https://{endpoint}/v3/{project_id}/tag-mgr/{resource_type}/tags

Request Header:  Content-Type: application/jsonX-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...

响应示例

状态码: 200

请求成功

{
  "tags" : [ {
    "resource_id" : "hilens-5b54c065e57c47e0bb44291a07371dd8",
    "value" : "v1",
    "key" : "k1"
  }, {
    "resource_id" : "hilens-8c6d32ab93ba49e9b8d149dbfd410e7f",
    "value" : "v2",
    "key" : "k3"
  }, {
    "resource_id" : "hilens-19a27038ee2f437ab41241a64a907589",
    "value" : "v3",
    "key" : "k3"
  }, {
    "resource_id" : "hilens-0cbda3fa887a4e00ad1fe82453b671e1",
    "value" : "v4",
    "key" : "k4"
  } ]
}

状态码

状态码

描述

200

请求成功

401

认证不通过

403

拒绝执行请求

404

请求的资源不存在

500

服务器内部错误

错误码

请参见错误码

相关文档