日志接口
更新时间：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时间 |
请求示例
POST /v2/log/list HTTP/1.1
Host: cdn.baidubce.com
{
"type":2,
"domains":[
"xiao01097.baidu.com"
],
"startTime":"2019-03-04T00:00:00Z",
"endTime":"2019-03-04T23:00:00Z",
"pageNo":1,
"pageSize":1000
}返回示例
HTTP/1.1 200
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
"startTime":"2019-03-04T00:00:00Z",
"endTime":"2019-03-04T23:00:00Z",
"urls":[
{
"domain":"xiao01097.baidu.com",
"name":"1.text",
"logTimeBegin":"2019-03-04T04:00:00Z",
"logTimeEnd":"2019-03-04T05:00:00Z",
"size":100,
"url":"http://XXX"
}
],
"totalCount":1
}