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

文档中心

立即注册

导航

查询URL排行统计数据

最近更新时间：2025.05.30 10:49:11首次发布时间：2021.12.27 17:16:07

查询URL排行统计数据。可根据流量、峰值带宽、请求数、峰值QPS排行。

请求说明

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

请求参数

Query

参数名称	数据类型	是否必选	参数说明
Action	String	是	接口名称。当前 API 的名称为 `DescribeTopUrls`。
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"]`

返回参数

参数名称	数据类型	参数说明	示例
URL	String	URL。	`/v1/`
Rank	Float	排名。	`1`
Request	Float	请求数。	`20`
Traffic	Float	流量。	`20`
Bandwidth	Float	峰值带宽。	`20`
QPS	Float	峰值 QPS 。	`20`

请求示例

POST https://open.volcengineapi.com?Action=DescribeTopUrls&Version=2021-04-01
{
    "StartTime": "2025-05-01 00:00:00",
    "EndTime": "2025-105-02 00:00:00",
    "Sort": "request",
    "Domain": "dcdn.example.com"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2025053010021049C3A93507A779D2D364",
        "Action": "DescribeTopURLs",
        "Version": "2021-04-01",
        "Service": "DCDN",
        "Region": "cn-north-01"
    },
    "Result": [
        {
            "Bandwidth": 176.8266666,
            "QPS": 0.0033334000000000003,
            "Rank": 1,
            "Request": 5,
            "Traffic": 15264,
            "URL": "dcdn.example.com/"
        },
        {
            "Bandwidth": 269.3333334,
            "QPS": 0.0033334000000000003,
            "Rank": 2,
            "Request": 1,
            "Traffic": 10100,
            "URL": "dcdn.example.com/test1.html"
        },
        {
            "Bandwidth": 153.28,
            "QPS": 0.0033334000000000003,
            "Rank": 3,
            "Request": 1,
            "Traffic": 5748,
            "URL": "dcdn.example.com/private/test2.html"
        },
        {
            "Bandwidth": 153.2533334,
            "QPS": 0.0033334000000000003,
            "Rank": 4,
            "Request": 1,
            "Traffic": 5747,
            "URL": "dcdn.example.com/test3.html"
        },
        {
            "Bandwidth": 152.3466666,
            "QPS": 0.0033334000000000003,
            "Rank": 5,
            "Request": 1,
            "Traffic": 5713,
            "URL": "dcdn.example.com/path1/test4.html"
        },
        {
            "Bandwidth": 150.64000000000001,
            "QPS": 0.0033334000000000003,
            "Rank": 6,
            "Request": 1,
            "Traffic": 5649,
            "URL": "dcdn.example.com/test5.html"
        },
        {
            "Bandwidth": 148.1866666,
            "QPS": 0.0033334000000000003,
            "Rank": 7,
            "Request": 1,
            "Traffic": 5557,
            "URL": "dcdn.example.com/non-cache/test6.html"
        },
        {
            "Bandwidth": 19.813333399999998,
            "QPS": 0.0033334000000000003,
            "Rank": 8,
            "Request": 1,
            "Traffic": 743,
            "URL": "dcdn.example.com/.env"
        }
    ]
}