日志接口
更新时间: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}