统计接口
更新时间：2026-05-18
接口
本接口用于查询用户站点维度或域名维度的统计指标信息。
| Method | Path | 说明 |
|---|---|---|
| POST | /v2/stat/query | 查询用户站点维度或域名维度的统计指标信息接口。 |
请求体（Request Body）
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| metric | 必选 | array<String> | 指标类型。 指标类型合法值如下： • sum_bps: 总带宽。 • upstream_bps: 请求带宽（上行）。 • download_bps：响应带宽（下行）。 • sum_flow: 总流量。 • upstream_flow: 请求流量（上行）。 • download_flow：响应流量（下行）。 • pv：请求次数（状态码也通过该指标进行查询）。 |
| endTime | 可选 | Timestamp | 查询的时间范围结束值，默认为当前时间，UTC 时间。 |
| startTime | 可选 | Timestamp | 查询的时间范围起始值，默认为 endTime 前推 24 小时，UTC 时间。最长可查询近 31 天的数据。 • 时间长度 <= 2 天：默认 5 分钟粒度； • 2 天 < 时间长度 <= 7 天：默认 1 小时粒度； • 7 天 < 时间长度 <= 31 天：1 天粒度。 |
| showType | 可选 | String | 展示类型，默认 time，比如: • peak：返回峰值。 • time：返回依据时间的打点数。 • sum：返回聚合。 • top：返回 top 数据（当前支持 metric：sum_flow、upstream_flow、download_flow、pv）。 |
| group | 可选 | array<String> | 聚合字段。 |
| filter | 可选 | List<FilterItem> | 过滤条件。 |
FilterItem 类型说明
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| key | 必选 | String | 过滤的 key。当前支持： • site：站点。 • host：域名。 |
| value | 必选 | array<String> | key 对应的 value，支持设置多个。 |
| operation | 必选 | String | 操作类型，当前支持： • equal：等于。 • notequal：不等于。 |
响应体（Response Body）
类型一： 时间打点数据展示
| 参数 | 是否一定存在 | 类型 | 说明 |
|---|---|---|---|
| metricItemName | 是 | List<Data> | 响应的指标信息。 |
Data 类型说明
| 参数 | 是否一定存在 | 类型 | 说明 |
|---|---|---|---|
| timestamp | 是 | Int | 时间戳。 |
| value | 是 | String | 响应的指标值。 |
使用条件：
1.请求体中无 group 参数：标识不需要进行特定维度聚合。
2.showType 为 time：表示以打点数形式进行展示。
类型二： 峰值数据展示
| 参数 | 是否一定存在 | 类型 | 说明 |
|---|---|---|---|
| metricItemName | 是 | List<Data> | 响应的指标信息。 |
Data 类型说明
| 参数 | 是否一定存在 | 类型 | 说明 |
|---|---|---|---|
| timestamp | 是 | Int | 时间戳。此时值为 null。 |
| value | 是 | String | 响应的指标值。 |
| groupParams | 是 | List<GroupParams> | 聚合参数列表，此时为空。 |
使用条件：
1.请求体中无 group 参数：标识不需要进行特定维度聚合。
2.showType 为 peak：表示以峰值形式展示。
类型三： 时间打点带 group 参数数据展示
| 参数 | 是否一定存在 | 类型 | 说明 |
|---|---|---|---|
| metricItemName | 是 | List<Data> | 响应的指标信息。 |
Data 类型说明
| 参数 | 是否一定存在 | 类型 | 说明 |
|---|---|---|---|
| timestamp | 是 | Int | 时间戳。 |
| value | 是 | String | 响应的指标值。 |
| groupParams | 是 | List<GroupParams> | 聚合参数列表，此时其列表内容为请求体中 group 参数数据。 |
使用条件：
1.请求体中有 group 参数：该参数支持针对某个指定字段进行聚合，比如 host，那么得到的就是按照 host 聚合的多个数据。
2.showType 为 time：表示以打点数形式进行展示。
类型四： 聚合带 group 参数数据展示
| 参数 | 是否一定存在 | 类型 | 说明 |
|---|---|---|---|
| metricItemName | 是 | List<Data> | 响应的指标信息。 |
Data 类型说明
| 参数 | 是否一定存在 | 类型 | 说明 |
|---|---|---|---|
| timestamp | 是 | Int | 时间戳。此时值为 null。 |
| value | 是 | String | 响应的指标值。 |
| groupParams | 是 | List<GroupParams> | 聚合参数列表，此时其列表内容为请求体中 group 参数数据。 |
使用条件：
1.请求体中有 group 参数：该参数支持针对某个指定字段进行聚合，比如 host，那么得到的就是按照 host 聚合的多个数据。
2.showType 为 sum：表示以和值形式展示。
类型五： TOP带 group 参数数据展示
| 参数 | 是否一定存在 | 类型 | 说明 |
|---|---|---|---|
| metricItemName | 是 | List<Data> | 响应的指标信息。 |
Data 类型说明
| 参数 | 是否一定存在 | 类型 | 说明 |
|---|---|---|---|
| timestamp | 是 | Int | 时间戳。此时值为 null。 |
| value | 是 | String | 响应的指标值。 |
| groupParams | 是 | List<GroupParams> | 聚合参数列表，此时其列表内容为请求体中 group 参数数据。 |
使用条件：
1.有 group 参数：该参数支持针对某个字段进行 TOP 排序。比如 host，那么得到的就是按照 host 进行 Top 排序的多个数据。
2.showType 为 top：表示以 top 形式展示。
请求示例 1：根据站点查询总带宽峰值、请求带宽峰值、响应带宽峰值数据
请求示例
JSON
1POST /v2/geo/stat HTTP/1.1
2Host: geo.baidubce.com
3
4{
5 "startTime": "2026-05-10T16:00:00Z",
6 "endTime": "2026-05-11T09:06:29Z",
7 "filter": [
8 {
9 "key": "site",
10 "operation": "equal",
11 "value": [
12 "test.com"
13 ]
14 }
15 ],
16 "metrics": [
17 "sum_bps",
18 "upstream_bps",
19 "download_bps"
20 ],
21 "showType": "peak"
22}返回示例
JSON
1HTTP/1.1 200 OK
2
3{
4 "sum_bps": [
5 {
6 "timestamp": null,
7 "groupParams": [],
8 "value": 1554808
9 }
10 ],
11 "upstream_bps": [
12 {
13 "timestamp": null,
14 "groupParams": [],
15 "value": 306357
16 }
17 ],
18 "download_bps": [
19 {
20 "timestamp": null,
21 "groupParams": [],
22 "value": 1389709
23 }
24 ]
25}请求示例 2：根据站点查询总带宽打点数据
请求示例
JSON
1POST /v2/geo/stat HTTP/1.1
2Host: geo.baidubce.com
3
4{
5 "startTime": "2026-05-10T16:00:00Z",
6 "endTime": "2026-05-11T09:06:29Z",
7 "filter": [
8 {
9 "key": "site",
10 "operation": "equal",
11 "value": [
12 "test.com"
13 ]
14 }
15 ],
16 "metrics": [
17 "sum_bps"
18 ],
19 "showType": "time"
20}返回示例
JSON
1HTTP/1.1 200 OK
2
3{
4 "sum_bps": [
5 {
6 "timestamp": 1778442000,
7 "groupParams": [],
8 "value": 306
9 },
10 {
11 "timestamp": 1778440800,
12 "groupParams": [],
13 "value": 254
14 }
15 ]
16}请求示例 3：根据站点查询总流量、请求流量、响应流量总和数据
请求示例
JSON
1POST /v2/geo/stat HTTP/1.1
2Host: geo.baidubce.com
3
4{
5 "startTime": "2026-05-10T16:00:00Z",
6 "endTime": "2026-05-11T09:06:29Z",
7 "filter": [
8 {
9 "key": "site",
10 "operation": "equal",
11 "value": [
12 "test.com"
13 ]
14 }
15 ],
16 "metrics": [
17 "sum_flow",
18 "upstream_flow",
19 "download_flow"
20 ],
21 "showType": "sum"
22}返回示例
JSON
1HTTP/1.1 200 OK
2
3{
4 "sum_flow": [
5 {
6 "timestamp": null,
7 "groupParams": [],
8 "value": 281218781
9 }
10 ],
11 "upstream_flow": [
12 {
13 "timestamp": null,
14 "groupParams": [],
15 "value": 33523768
16 }
17 ],
18 "download_flow": [
19 {
20 "timestamp": null,
21 "groupParams": [],
22 "value": 247695013
23 }
24 ]
25}请求示例 4：根据站点查询总流量打点数据
请求示例
JSON
1POST /v2/geo/stat HTTP/1.1
2Host: geo.baidubce.com
3
4{
5 "startTime": "2026-05-10T16:00:00Z",
6 "endTime": "2026-05-11T09:06:29Z",
7 "filter": [
8 {
9 "key": "site",
10 "operation": "equal",
11 "value": [
12 "test.com"
13 ]
14 }
15 ],
16 "metrics": [
17 "sum_flow"
18 ],
19 "showType": "time"
20}返回示例
JSON
1HTTP/1.1 200 OK
2
3{
4 "sum_flow": [
5 {
6 "timestamp": 1778442000,
7 "groupParams": [],
8 "value": 11508
9 },
10 {
11 "timestamp": 1778440800,
12 "groupParams": [],
13 "value": 9517
14 }
15 ]
16}请求示例 5：根据站点查询请求总次数数据
请求示例
JSON
1POST /v2/geo/stat HTTP/1.1
2Host: geo.baidubce.com
3
4{
5 "startTime": "2026-05-10T16:00:00Z",
6 "endTime": "2026-05-11T09:06:29Z",
7 "filter": [
8 {
9 "key": "site",
10 "operation": "equal",
11 "value": [
12 "test.com"
13 ]
14 }
15 ],
16 "metrics": [
17 "pv"
18 ],
19 "showType": "sum"
20}返回示例
JSON
1HTTP/1.1 200 OK
2
3{
4 "pv": [
5 {
6 "timestamp": null,
7 "groupParams": [],
8 "value": 301424
9 }
10 ]
11}请求示例 6：根据站点查询峰值请求次数数据
请求示例
JSON
1POST /v2/geo/stat HTTP/1.1
2Host: geo.baidubce.com
3
4{
5 "startTime": "2026-05-10T16:00:00Z",
6 "endTime": "2026-05-11T09:06:29Z",
7 "filter": [
8 {
9 "key": "site",
10 "operation": "equal",
11 "value": [
12 "test.com"
13 ]
14 }
15 ],
16 "metrics": [
17 "pv"
18 ],
19 "showType": "peak"
20}返回示例
JSON
1HTTP/1.1 200 OK
2
3{
4 "pv": [
5 {
6 "timestamp": null,
7 "groupParams": [],
8 "value": 107703
9 }
10 ]
11}请求示例 7：根据站点查询请求数打点数据
请求示例
JSON
1POST /v2/geo/stat HTTP/1.1
2Host: geo.baidubce.com
3
4{
5 "startTime": "2026-05-10T16:00:00Z",
6 "endTime": "2026-05-11T09:06:29Z",
7 "filter": [
8 {
9 "key": "site",
10 "operation": "equal",
11 "value": [
12 "test.com"
13 ]
14 }
15 ],
16 "metrics": [
17 "pv"
18 ],
19 "showType": "time"
20}返回示例
JSON
1HTTP/1.1 200 OK
2
3{
4 "pv": [
5 {
6 "timestamp": 1778442000,
7 "groupParams": [],
8 "value": 10
9 },
10 {
11 "timestamp": 1778440800,
12 "groupParams": [],
13 "value": 9
14 }
15 ]
16}请求示例 8：根据站点查询状态码总和数据
请求示例
JSON
1POST /v2/geo/stat HTTP/1.1
2Host: geo.baidubce.com
3
4{
5 "startTime": "2026-05-10T16:00:00Z",
6 "endTime": "2026-05-11T11:05:47Z",
7 "filter": [
8 {
9 "key": "site",
10 "operation": "equal",
11 "value": [
12 "test.com"
13 ]
14 }
15 ],
16 "metrics": [
17 "pv"
18 ],
19 "showType": "sum",
20 "group": [
21 "code"
22 ]
23}返回示例
JSON
1HTTP/1.1 200 OK
2
3{
4 "pv": [
5 {
6 "timestamp": null,
7 "groupParams": {
8 "code": "3xx"
9 },
10 "value": 7
11 },
12 {
13 "timestamp": null,
14 "groupParams": {
15 "code": "2xx"
16 },
17 "value": 923
18 },
19 {
20 "timestamp": null,
21 "groupParams": {
22 "code": "4xx"
23 },
24 "value": 300470
25 },
26 {
27 "timestamp": null,
28 "groupParams": {
29 "code": "5xx"
30 },
31 "value": 24
32 }
33 ]
34}请求示例 9：根据站点查询状态码打点数据
请求示例
JSON
1POST /v2/geo/stat HTTP/1.1
2Host: geo.baidubce.com
3
4{
5 "startTime": "2026-05-10T16:00:00Z",
6 "endTime": "2026-05-11T11:05:47Z",
7 "filter": [
8 {
9 "key": "site",
10 "operation": "equal",
11 "value": [
12 "test.com"
13 ]
14 }
15 ],
16 "metrics": [
17 "pv"
18 ],
19 "showType": "time",
20 "group": [
21 "code"
22 ]
23}返回示例
JSON
1HTTP/1.1 200 OK
2
3{
4 "pv": [
5 {
6 "timestamp": 1778442600,
7 "groupParams": {
8 "code": "2xx"
9 },
10 "value": 5
11 },
12 {
13 "timestamp": 1778429700,
14 "groupParams": {
15 "code": "5xx"
16 },
17 "value": 1
18 }
19 ]
20}评价此篇文章