文档首页/华为HiLens/API参考/API（专业版控制台）/标签管理/查询资源标签
更新时间：2023-04-24 GMT+08:00
查看PDF
分享

查询资源标签

功能介绍

专业版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

服务器内部错误

错误码

请参见错误码。

父主题：标签管理

相关文档