离线日志接口
更新时间：2026-04-07
离线日志接口
本接口用于获取用户某个站点下单个域名或多个域名某一指定时间段内的日志下载地址。日志的保存时间为180天。
| Method | Path | 说明 |
|---|---|---|
| POST | /v2/geo/log | 获取某个站点的单个域名或多个域名的日志下载地址 |
请求体（Request Body）
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| site | 必选 | String | 站点名称。 |
| endTime | 可选 | Timestamp | 查询的时间范围结束值，默认为当前时间，UTC 时间。 |
| startTime | 可选 | Timestamp | 查询的时间范围起始值，默认为 endTime 参数值前推 8 小时，UTC 时间。 |
| domainList | 可选 | List<String> | 查询的域名列表。 |
| pageNo | 可选 | Int | 分页编号，默认值为 1 。 |
| pageSize | 可选 | Int | 每页返回日志数目，默认值 为 20 。 |
响应体（Response Body）
| 参数 | 类型 | 说明 |
|---|---|---|
| logEntryList | List<LogEntry> | 离线日志列表。 |
| totalCount | Int | 离线日志列表总数。 |
LogEntry类型说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| domain | String | 域名。 |
| url | String | 可下载离线日志的 url 。 |
| name | String | 离线日志文件的名称。 |
| size | Int | 离线日志文件的大小，单位为 B 。 |
| logTimeBegin | Timestamp | 文件中的日志开始时间，UTC 时间。 |
| logTimeEnd | Timestamp | 文件中的日志结束时间，UTC 时间。 |
请求示例
JSON
1POST /v2/geo/log HTTP/1.1
2Host: geo.baidubce.com
3
4{
5 "site": "test.com",
6 "startTime": "2026-03-10T16:00:00Z",
7 "endTime": "2026-03-11T03:59:42Z",
8 "domainList": [
9 "1.test.com"
10 ],
11 "pageNo": 1,
12 "pageSize": 20
13}返回示例
JSON
1HTTP/1.1 200
2Server: nginx/1.16.1
3Content-Type: application/json; charset=utf-8
4Transfer-Encoding: chunked
5Connection: keep-alive
6
7{
8 "totalCount": "2",
9 "logEntryList": [
10 {
11 "domain": "1.test.com",
12 "name": "your_log_name_1",
13 "logTimeBegin": "2026-03-10T16:00:00Z",
14 "logTimeEnd": "2026-03-10T17:00:00Z",
15 "size": 15113,
16 "url": "https://XXX"
17 },
18 {
19 "domain": "1.test.com",
20 "name": "your_log_name_2",
21 "logTimeBegin": "2026-03-10T17:00:00Z",
22 "logTimeEnd": "2026-03-10T18:00:00Z",
23 "size": 772,
24 "url": "https://XXX"
25 }
26 ]
27}评价此篇文章