文档中心

全球加速

监控相关接口

查询 TOP 统计数据 DescribeTopStatistics

按指定时间范围查询一组加速器或监听器的 TOP 监控统计数据，并按排序指标降序返回每个资源的排名、最大带宽、95 峰值带宽、最大连接数和总流量。适用于识别统计值较高的资源。

请求说明

请求方式：POST
请求地址：https://ga.volcengine-api.com?Action=DescribeTopStatistics&Version=2022-03-01

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

参数	类型	是否必填	示例值	描述
Action	String	是	`DescribeTopStatistics`	要执行的操作，取值：`DescribeTopStatistics`。
Version	String	是	`2022-03-01`	API 的版本，取值：`2022-03-01`。

Body

参数	类型	是否必填	示例值	描述
InputIdType	String	是	`AcceleratorId`	查询的资源 ID 类型，决定 `InputId` 中传入的是哪类资源的 ID。取值： `AcceleratorId`：按加速器 ID 查询。 `ListenerId`：按监听器 ID 查询。
StartTime	String	是	`2023-06-04 00:00:00`	查询的起始时间。格式为 `yyyy-MM-dd HH:mm:ss`，使用北京时间（`UTC+8`）。
EndTime	String	是	`2023-06-04 23:59:59`	查询的结束时间，与 `StartTime` 共同界定统计窗口。格式为 `yyyy-MM-dd HH:mm:ss`，使用北京时间（`UTC+8`）。
SortMetric	String	否	`MaxBandwidth`	排序指标，TOP 列表按该指标降序排列。取值： `MaxConnectionNum`：总峰值并发数 `MaxBandwidth`：峰值带宽 `TotalTraffic`：总流量 `MaxBandwidth95`：95 峰值带宽
InputId	String[]	是	`["accinstance-YfiSM6k5BspFcC4BaG****"]`	待查询的资源 ID 列表，元素类型由 `InputIdType` 决定（加速器 ID 或监听器 ID）。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
SortMetric	String	`MaxBandwidth`	排序指标，TOP 列表按该指标降序排列。
TopStatistics	Object[]		TOP 资源统计列表，按排序指标降序排列，每个元素为一个资源的统计数据。

请求示例

POST https://ga.volcengine-api.com?Action=DescribeTopStatistics&Version=2022-03-01
{
  "InputIdType": "AcceleratorId",
  "StartTime": "2021-01-01 00:00:00",
  "EndTime": "2021-01-01 23:59:59",
  "InputId": [
    "accinstance-YfiSM6k5BspFcC4BaG****"
  ]
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "2024112011264709219518102344DA67",
    "Action": "DescribeTopStatistics",
    "Version": "2022-03-01",
    "Service": "ga",
    "Region": "cn-beijing"
  },
  "Result": {
    "SortMetric": "MaxBandwidth",
    "TopStatistics": [
      {
        "ID": "accinstance-YfiSM6k5BspFcC4BaG****",
        "MaxBandwidth": 883.7035717022975,
        "MaxBandwidth95": 53.720453264005464,
        "MaxConnectionNum": 314.3539566152018,
        "Name": "nVqU5B",
        "Rank": 420,
        "TotalTraffic": 849.9343350580577
      }
    ]
  }
}

错误码

本接口无专用错误码。公共错误码请参见公共错误码。

最近更新时间：2026.09.23 16:20:54

这个页面对您有帮助吗？

有用

无用

全球加速

请求说明 #

请求参数 #

Query #

Body #

返回参数 #

请求示例 #

返回示例 #

错误码 #