更新时间：2026-08-13 GMT+08:00

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

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

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

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
ces:tags:list	List	-	-	ces:projecttags:list	-

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

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释: 项目ID。用于明确项目归属，配置后可通过该ID查询项目下资产，可以通过调用API获取，也可以从控制台获取。获取方式请参见获取项目ID。约束限制: 不涉及。取值范围: 字符串的长度必须在 1 到 64个字符之间。默认取值: 不涉及。
resource_type	是	String	参数解释：资源类型。约束限制：不涉及。取值范围：只能为CES-alarm，代表告警规则。长度[1,32]个字符。长度1到32个字符。默认取值：不涉及。

表2 请求Header参数
参数	是否必选	参数类型	描述
Content-Type	否	String	参数解释: 发送的实体的MIME类型。约束限制: 不涉及。取值范围: 最小字符数量为1，最大为64。默认取值: 默认使用application/json; charset=UTF-8。
X-Auth-Token	否	String	参数解释: 用户Token。Token认证，具体操作请参考认证鉴权。约束限制: 不涉及。取值范围: 最小字符数量为1，最大为16384。默认取值: 不涉及。

状态码：200

表3 响应Body参数
参数	参数类型	描述
tags	Array of TagResp objects	参数解释：租户标签列表。

表4 TagResp
参数	参数类型	描述
key	String	参数解释：标签名。取值范围：最大长度128个unicode字符。
values	Array of strings	参数解释：标签值。

状态码：404

表5 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：用于标识请求异常的具体原因。取值范围：字符串长度为0到256个字符。
error_msg	String	参数解释：用于描述请求异常的具体信息。取值范围：字符串长度为0到256个字符。
request_id	String	参数解释：用于唯一标识一次请求，便于问题追踪。取值范围：字符串长度为0到256个字符。

请求样例：查询CES指定项目，资源类型为CES-alarm的标签列表

GET https://{云监控的endpoint}/v2/{project_id}/CES-alarm/tags

状态码：200

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

状态码	描述
200	OK
404	资源未找到

请参见错误码。

父主题： 资源标签管理