查询聚合器中账号资源的计数_资源聚合器_API_API参考（吉隆坡区域）

功能介绍

查询聚合器中账号资源的计数，支持通过过滤器和GroupByKey来统计资源数量。

调用方法

URI

POST /v1/resource-manager/domains/{domain_id}/aggregators/aggregate-data/aggregate-discovered-resource-counts

表1 路径参数
参数	是否必选	参数类型	描述
domain_id	是	String	账号ID。最大长度：36

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Security-Token	否	String	如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。

表3 请求Body参数
参数	是否必选	参数类型	描述
aggregator_id	是	String	资源聚合器ID。最小长度：1 最大长度：256
filter	否	ResourceCountsFilters object	资源计数过滤器。
group_by_key	是	String	用于对资源计数进行分组的键（RESOURCE_TYPE \| ACCOUNT_ID）。最小长度：1 最大长度：16

表4 ResourceCountsFilters
参数	是否必选	参数类型	描述
account_id	否	String	账号ID。最小长度：1 最大长度：36
resource_type	否	String	资源类型。最小长度：1 最大长度：32
region_id	否	String	区域ID。最小长度：1 最大长度：32

响应参数

状态码： 200

表5 响应Body参数
参数	参数类型	描述
group_by_key	String	资源计数进行分组的键。
grouped_resource_counts	Array of GroupedResourceCount objects	分组资源计数的列表。
total_discovered_resources	Integer	指定过滤器的资源聚合器中存在的资源总数。

表6 GroupedResourceCount
参数	参数类型	描述
group_name	String	分组名称。
resource_count	Integer	资源数量。

状态码： 400

表7 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	错误消息内容。

状态码： 403

表8 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	错误消息内容。

状态码： 500

表9 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	错误消息内容。

请求示例

查询聚合器中账号资源的计数。

POST https://{endpoint}/v1/resource-manager/domains/{domain_id}/aggregators/aggregate-data/aggregate-discovered-resource-counts

{
  "aggregator_id" : "7ca3447830bd49c9b630a99680eaf90f",
  "group_by_key" : "DOMAIN"
}

响应示例

状态码： 200

操作成功。

{
  "group_by_key" : "DOMAIN",
  "grouped_resource_counts" : [ {
    "group_name" : "3fd23817bd85480e8dc4f520075de348",
    "resource_count" : 23
  } ],
  "total_discovered_resources" : 23
}

状态码

状态码	描述
200	操作成功。
400	输入参数不合法。
403	用户认证失败或无操作权限。
500	服务器内部错误。

错误码

请参见错误码。

查询聚合器中账号资源的计数