查询IP排行统计数据 DescribeTopIPs--全站加速-火山引擎

文档中心

全站加速

数据监控接口

查询IP排行统计数据 DescribeTopIPs

查询客户端 IP 排行统计数据。

请求说明

请求方式：POST
请求地址：https://open.volcengineapi.com?Action=DescribeTopIPs&Version=2021-04-01

请求参数

Query

参数名称	数据类型	是否必选	参数说明
Action	String	是	接口名称。当前 API 的名称为 `DescribeTopIPs`。
Version	String	是	接口版本。当前 API 的版本为 `2021-04-01`。

Body

参数名称	数据类型	是否必选	参数说明	示例
StartTime	String	是	查询起始时间。	`2021-01-01 00:00:00`
EndTime	String	是	查询结束时间。	`2021-01-01 23:59:59`
Sort	String	是	指定排序指标。取值： `traffic`：流量。 `bandwidth`：峰值带宽。 `request`: 请求数。 `QPS`: 峰值 QPS 。	`traffic`
Limit	Integer	否	域名获取数量限制，默认为20，取值支持1~100 。	`20`
ProjectName	String[]	否	指定查询域名所属的项目，为空代表查询当前用户所有项目。	`["test"]`
Domain	String	否	指定查询域名，不填默认全选。需要指定完整加速域名，不支持域名部分匹配。	`test.com`
StatusCode	String[]	否	指定查询状态码：2xx、3xx、4xx、5xx。	`["2xx"]`

返回参数

参数名称	数据类型	参数说明	示例
IP	String	客户端 IP 地址。	`203.0.113.99`
Rank	Float	排名。	`1`
Request	Float	请求数。	`20`
Traffic	Float	流量。单位：byte。	`15264`
Bandwidth	Float	带宽峰值。单位：bps。	`176.8266666`
QPS	Float	峰值 QPS 。	`0.0033334000000000003`

请求示例

POST https://open.volcengineapi.com?Action=DescribeTopIPs&Version=2021-04-01
{
    "StartTime": "2025-05-13 00:00:00",
    "EndTime": "2025-05-13 01:00:00",
    "Sort": "traffic"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202505301130117A7FD33A7FF317AB8AB0",
        "Action": "DescribeTopIPs",
        "Version": "2021-04-01",
        "Service": "DCDN",
        "Region": "cn-north-01"
    },
    "Result": [
        {
            "Bandwidth": 269.3333334,
            "IP": "203.0.113.99",
            "QPS": 0.0033334000000000003,
            "Rank": 1,
            "Request": 3,
            "Traffic": 17323
        },
        {
            "Bandwidth": 176.8266666,
            "IP": "203.0.113.100",
            "QPS": 0.0033334000000000003,
            "Rank": 2,
            "Request": 2,
            "Traffic": 7302
        }
    ]
}

最近更新时间：2026.05.25 16:53:18

这个页面对您有帮助吗？

有用

无用

全站加速

请求说明 #

请求参数 #

Query #

Body #

返回参数 #

请求示例 #

返回示例 #

请求说明

请求参数

Query

Body

返回参数

请求示例

返回示例