文档首页/ 配置审计 Config/ API参考（吉隆坡区域）/ API/ 资源聚合器/ 对指定聚合器执行高级查询
更新时间：2026-08-24 GMT+08:00
查看PDF
分享

对指定聚合器执行高级查询

功能介绍

对指定聚合器执行高级查询。

调用方法

请参见如何调用API。

URI

POST /v1/resource-manager/domains/{domain_id}/aggregators/{aggregator_id}/run-query

表1 路径参数

参数

是否必选

参数类型

描述

domain_id

是

String

账号ID。

最大长度：36

aggregator_id

是

String

资源聚合器ID。

最大长度：32

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Security-Token

否

String

如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。
表3 请求Body参数

参数

是否必选

参数类型

描述

expression

是

String

ResourceQL表达式。

最小长度：1

最大长度：4096

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

query_info

QueryInfo object

ResourceQL查询字段。

results

Array of objects

ResourceQL查询结果。
表5 QueryInfo

参数

参数类型

描述

select_fields

Array of strings

ResourceQL查询字段。

状态码： 400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息内容。

状态码： 403

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息内容。

状态码： 500

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息内容。

请求示例

查询当前组织下所有虚拟机的ID。

POST https://{endpoint}/v1/resource-manager/domains/{domain_id}/aggregators/{aggregator_id}/run-query

{
  "expression" : "select id from aggregator_resources where provider = 'ecs' and type = 'cloudservers'"
}

响应示例

状态码： 200

操作成功。

{
  "query_info" : {
    "select_fields" : [ "id" ]
  },
  "results" : [ {
    "id" : "91252cc9-bfd9-0709-0912-56b397e0ba3f"
  } ]
}

状态码

状态码

描述

200

操作成功。

400

输入参数不合法。

403

用户认证失败或无操作权限。

500

服务器内部错误。

错误码

请参见错误码。

父主题： 资源聚合器