文档首页/ 云监控服务 CES/ API参考/ API/ 资源分组/ 资源分组关联资源/ 查询资源分组下指定服务类别特定维度的资源列表
更新时间：2025-08-26 GMT+08:00
查看PDF
分享

查询资源分组下指定服务类别特定维度的资源列表

功能介绍

查询资源分组下指定服务类别特定维度的资源列表

调试

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

URI

GET /v2/{project_id}/resource-groups/{group_id}/services/{service}/resources

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户ID

group_id

是

String

资源分组ID，以rg开头，后跟22位由字母或数字组成的字符串

service

是

String

服务类别，如SYS.ECS
表2 Query参数

参数

是否必选

参数类型

描述

dim_name

否

String

资源维度信息，多个维度按字母序使用逗号分隔

limit

否

String

分页查询时每页的条目数，取值[1,100]，默认值为100

offset

否

Integer

分页查询时查询的起始位置，表示从第几条数据开始，默认为0

取值范围：

0-10000

status

否

String

按状态信息进行过滤，取值只能为health（已设置告警规则且无告警触发的资源）、unhealthy（已设置告警规则且有告警触发的资源）、no_alarm_rule（未设置告警规则的资源）

枚举值：

  • health

  • unhealthy

  • no_alarm_rule

dim_value

否

String

资源维度值，不支持模糊匹配，但是多维度资源可以只指定一个维度值

tag

否

String

资源的标签信息，格式："[key]":"[value]"，样例参考："ssss":"1111"

extend_relation_id

否

String

企业项目ID

product_name

否

String

资源分组的云产品，一般由"服务命名空间,服务首层维度名称"组成，如"SYS.ECS,instance_id"

resource_name

否

String

资源名称

正则匹配：^$|^([\u4E00-\u9FFF]|[a-z]|[A-Z]|[0-9]|_|-|\\.|)+$

event_status

否

String

按事件告警状态信息进行过滤，取值只能为health（已设置事件告警规则且无事件告警触发的资源）、unhealthy（已设置事件告警规则且有事件告警触发的资源）、no_alarm_rule（未设置事件告警规则的资源）

枚举值：

  • health

  • unhealthy

  • no_alarm_rule

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

租户Token

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

count

Integer

资源总数

取值范围：

0-10000

resources

Array of GetResourceGroupResources objects

资源分组资源列表
表5 GetResourceGroupResources

参数

参数类型

描述

status

String

指标告警状态，取值为health（告警中）、unhealthy（已触发）、no_alarm_rule（未设置告警规则）

枚举值：

  • health

  • unhealthy

  • no_alarm_rule

dimensions

Array of ResourceDimension objects

资源的维度信息

tags

String

资源的tag信息,格式为key/value的json字符串,样例为"{"sss":"aaa"}"

enterprise_project_id

String

企业项目ID

event_status

String

事件告警状态，取值为health（告警中）、unhealthy（已触发）、no_alarm_rule（未设置告警规则）

枚举值：

  • health

  • unhealthy

  • no_alarm_rule

resource_name

String

资源名称
表6 ResourceDimension

参数

参数类型

描述

name

String

参数解释

资源维度，如：弹性云服务器，则维度为instance_id；目前最大支持4个维度，各服务资源的指标维度名称可查看：“服务指标维度”。

约束限制

不涉及

取值范围

由字母开头，后面可以包含字母、数字、_或-，长度为[1,32]个字符

默认取值

不涉及

正则匹配：^([a-z]|[A-Z]){1}([a-z]|[A-Z]|[0-9]|_|-)*$

value

String

参数解释

资源维度值，为资源的实例ID，如：4270ff17-aba3-4138-89fa-820594c39755。

约束限制

不涉及

取值范围

长度为[1,256]个字符

默认取值

不涉及

正则匹配：^((([a-z]|[A-Z]|[0-9]|\*|_|/|#|\(|\)){1}([a-z]|[A-Z]|[0-9]|_|-|\.|\*|/|#|\(|\))*))$

状态码：400

表7 响应Body参数

参数

参数类型

描述

error_code

String

请求异常内部业务状态码

error_msg

String

请求异常信息

request_id

String

请求ID

状态码：401

表8 响应Body参数

参数

参数类型

描述

error_code

String

请求异常内部业务状态码

error_msg

String

请求异常信息

request_id

String

请求ID

状态码：403

表9 响应Body参数

参数

参数类型

描述

error_code

String

请求异常内部业务状态码

error_msg

String

请求异常信息

request_id

String

请求ID

状态码：404

表10 响应Body参数

参数

参数类型

描述

error_code

String

请求异常内部业务状态码

error_msg

String

请求异常信息

request_id

String

请求ID

状态码：500

表11 响应Body参数

参数

参数类型

描述

error_code

String

请求异常内部业务状态码

error_msg

String

请求异常信息

request_id

String

请求ID

请求示例

查询资源分组下指定服务类别特定维度的资源列表

'/v2/{project_id}/resource-groups/{group_id}/services/{service}/resources'

响应示例

状态码：200

OK

{
  "count" : 1000,
  "resources" : [ {
    "status" : "health",
    "dimensions" : [ {
      "name" : "instance_id",
      "value" : "4270ff17-aba3-4138-89fa-820594c39755"
    } ]
  } ]
}

状态码

状态码

描述

200

OK

400

参数校验失败

401

未认证

403

认证鉴权失败

404

资源不存在

500

系统内部错误

错误码

请参见错误码。

相关文档