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

查询资源标签

功能介绍

专业版HiLens控制台标签管理,查询具体资源的标签,返回标签列表。

URI

GET /v3/{project_id}/{resource_type}/{resource_id}/tags

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

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

resource_id

String

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

resource_type

String

资源类型(节点,部署,配置项,密钥)

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

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

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

count

Integer

满足条件的总数

tags

Array of TagObject objects

资源标签对列表

表4 TagObject

参数

参数类型

描述

key

String

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

value

String

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

请求示例

查询对应资源的标签

GET https://{endpoint}/v3/{project_id}/{resource_type}/{resource_id}/tags

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

响应示例

状态码: 200

请求成功

{
  "tags" : [ {
    "value" : "v1",
    "key" : "k1"
  } ],
  "count" : 1
}

状态码

状态码

描述

200

请求成功

401

认证不通过

403

拒绝执行请求

404

请求的资源不存在

500

服务器内部错误

错误码

请参见错误码

相关文档