日志接口
更新时间：2023-06-15
获取单个域名日志
本接口用于获取某一个域名某一指定时间段内的日志下载地址。日志的保存时间为180天。
| Method | Path | 说明 |
|---|---|---|
| GET | /v2/log/{domain}/log | 查询某个域名的日志下载地址 |
domain：CDN加速域名
URL参数
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| startTime | 可选 | timestamp | 获取日志的起始时间。UTC时间，默认为endTime前推8小时 |
| endTime | 可选 | timestamp | 获取日志的结束时间。UTC时间，默认为当前时间 |
| type | 可选 | int | 所要查询的日志类型。0：边缘日志，1：回源日志，2：动态加速日志，3：海外日志，4：xcdn日志，默认为0 |
响应体（Response Body）
| 参数 | 类型 | 说明 |
|---|---|---|
| logs | list<LogEntry> | 日志列表 |
LogEntry类型说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| url | string | 下载日志 |
| name | string | 日志文件名 |
| size | int | 文件size |
| startTime | timestamp | 文件中的日志开始时间，UTC时间 |
| endTime | timestamp | 文件中的日志结束时间，UTC时间 |
获取多个域名日志
本接口用于获取多个域名指定时间段内的日志下载地址。日志的保存时间为180天，即用户只可以下载180天以内的日志。
| Method | Path | 说明 |
|---|---|---|
| POST | /v2/log/list | 查询多个域名的日志下载地址 |
请求体（Request Body）
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| startTime | 必选 | timestamp | 获取日志的起始时间，UTC时间 |
| endTime | 必选 | timestamp | 获取日志的结束时间，UTC时间 |
| type | 可选 | int | 所要查询的日志类型。0：边缘日志，1：回源日志，2：动态加速日志，3：海外日志，4：xcdn日志，默认为0 |
| domains | 可选 | list<string> | 域名列表 |
| pageNo | 可选 | int | 分页编号，默认为1 |
| pageSize | 可选 | int | 每页返回日志数目，默认为1000 |
响应体（Response Body）
| 参数 | 类型 | 说明 |
|---|---|---|
| startTime | timestamp | 获取日志的起始时间，UTC时间 |
| endTime | timestamp | 获取日志的结束时间，UTC时间 |
| urls | list<LogEntry> | 日志url列表 |
| totalCount | int | url列表计数 |
LogEntry类型说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| domain | string | 域名 |
| url | string | 下载日志 |
| name | string | 日志文件名 |
| size | int | 文件size |
| logTimeBegin | timestamp | 文件中的日志开始时间，UTC时间 |
| logTimeEnd | timestamp | 文件中的日志结束时间，UTC时间 |
请求示例
JSON
1POST /v2/log/list HTTP/1.1
2Host: cdn.baidubce.com
3
4{
5 "type":2,
6 "domains":[
7 "xiao01097.baidu.com"
8 ],
9 "startTime":"2019-03-04T00:00:00Z",
10 "endTime":"2019-03-04T23:00:00Z",
11 "pageNo":1,
12 "pageSize":1000
13}返回示例
JSON
1HTTP/1.1 200
2Content-Length: 190
3Content-Type: application/json;utf-8
4x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
5Server: BCE-CDN
6
7{
8 "startTime":"2019-03-04T00:00:00Z",
9 "endTime":"2019-03-04T23:00:00Z",
10 "urls":[
11 {
12 "domain":"xiao01097.baidu.com",
13 "name":"1.text",
14 "logTimeBegin":"2019-03-04T04:00:00Z",
15 "logTimeEnd":"2019-03-04T05:00:00Z",
16 "size":100,
17 "url":"http://XXX"
18 }
19 ],
20 "totalCount":1
21}