日志接口
更新时间:2020-09-27
获取单个域名日志
本接口用于获取某一个域名某一指定时间段内的日志下载地址。日志的保存时间为180天。
Method | Path | 说明 |
---|---|---|
GET | /v2/log/{domain}/log | 提供某个域名的日志下载地址 |
domain:需要获取日志的域名
URL参数:
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
startTime | 必选 | Timestamp | 获取日志的起始时间,UTC时间 |
endTime | 必选 | Timestamp | 获取日志的结束时间,UTC时间 |
响应体(Response Body)
参数 | 类型 | 说明 |
---|---|---|
logs | list类型,LogEntry内容如下: - url: String类型,表示下载日志。 - name:String类型,表示日志文件名。 - size:Int类型,表示文件size。 - startTime:Timestamp类型,表示文件中的日志开始时间,UTC时间。 - endTime:Timestamp类型,表示文件中的日志结束时间,UTC时间。 |
日志url列表 |
获取多个域名日志
本接口用于获取多个域名指定时间段内的日志下载地址。日志的保存时间为180天,即用户只可以下载180天以内的日志。
Method | Path | 说明 |
---|---|---|
POST | /v2/log/list | 提供多个域名的日志下载地址 |
请求体(Request Body)
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
startTime | 必选 | Timestamp | 获取日志的起始时间,UTC时间 |
endTime | 必选 | Timestamp | 获取日志的结束时间,UTC时间 |
type | 可选 | Long | 0,边缘日志;1,回源日志;2,动态加速日志;3,海外日志 |
domains | 可选 | List<String> | 域名列表 |
pageNo | 可选 | int | 分页编号,从1开始 |
pageSize | 可选 | int | 每页返回日志数目 |
响应体(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
}