文档首页/ 云监控服务 CES/ API参考/ API/ 云资源监控/ 资源标签管理/ 查询CES指定项目指定资源类型标签列表
更新时间：2025-08-26 GMT+08:00
查看PDF
分享

查询CES指定项目指定资源类型标签列表

功能介绍

查询CES指定项目指定资源类型标签列表。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

GET /v2/{project_id}/{resource_type}/tags

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

租户ID。用于明确项目归属，配置后可通过该ID查询项目下资产，可以通过调用API获取，也可以从控制台获取。获取方式请参见“获取项目ID”。

约束限制:

不涉及。

取值范围:

字符串的长度必须在 1 到 64个字符之间。

默认取值:

不涉及。

resource_type

是

String

参数解释：

资源类型。

约束限制：

不涉及。

取值范围：

只能为CES-alarm，代表告警规则。长度[1,32]个字符。

默认取值：

不涉及。

枚举值：

  • CES-alarm

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

否

String

参数解释:

发送的实体的MIME类型。

约束限制:

不涉及。

取值范围:

最小字符数量为1，最大为64。

默认取值:

默认使用application/json; charset=UTF-8。

默认取值：

application/json; charset=UTF-8

X-Auth-Token

否

String

参数解释:

用户Token。

约束限制:

不涉及。

取值范围:

最小字符数量为1，最大为16384。

默认取值:

不涉及。

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

tags

Array of TagResp objects

参数解释：

租户标签列表。
表4 TagResp

参数

参数类型

描述

key

String

参数解释：

标签名。

取值范围：

最大长度128个unicode字符。

values

Array of strings

参数解释：

标签值。

取值范围：

每个值最大长度255个unicode字符。如果values为空列表，则表示查询任意value

状态码：404

表5 响应Body参数

参数

参数类型

描述

error_code

String

请求异常内部业务状态码

error_msg

String

请求异常信息

request_id

String

请求ID

请求示例

无

响应示例

状态码：200

OK

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

状态码

状态码

描述

200

OK

404

资源未找到

错误码

请参见错误码。

父主题： 资源标签管理

相关文档