更新时间:2025-08-30 GMT+08:00
分享

查询资源标签

功能介绍

查询指定实例的标签信息

标签管理服务需要使用该接口查询指定实例的全部标签数据

调用方法

请参见如何调用API

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

resource_type

String

资源类型

resource_id

String

资源ID

project_id

String

参数解释:

项目ID,用于明确项目归属,配置后可通过该ID查询项目下资产,可以通过调用API获取,也可以从控制台获取。获取项目ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-type

String

发送的实体的MIME类型。

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

tags

Array of Tag objects

标签列表

表4 Tag

参数

参数类型

描述

key

String

键。最大长度128个unicode字符。 key不能为空。(搜索时不对此参数做字符集校验),key不能为空或者空字符串,不能为空格,校验和使用之前先trim 前后半角空格。

values

Array of strings

值列表。每个值最大长度255个unicode字符,校验和使用之前先trim 前后半角空格。

value可为空数组但不可缺省。

如果values为空列表,则表示any_value(查询任意value)。value之间为或的关系。

状态码:400

表5 响应Body参数

参数

参数类型

描述

error_code

String

Error code.

error_msg

String

Error description.

状态码:401

表6 响应Body参数

参数

参数类型

描述

error_code

String

Error code.

error_msg

String

Error description.

状态码:403

表7 响应Body参数

参数

参数类型

描述

error_code

String

Error code.

error_msg

String

Error description.

状态码:404

表8 响应Body参数

参数

参数类型

描述

error_code

String

Error code.

error_msg

String

Error description.

状态码:500

表9 响应Body参数

参数

参数类型

描述

error_code

String

Error code.

error_msg

String

Error description.

请求示例

响应示例

状态码

状态码

描述

200

OK

400

参数非法

401

鉴权失败

403

权限不足

404

资源未找到

500

系统异常

错误码

请参见错误码

相关文档