查询加速域名的访问日志
适用产品
CDN Pro
接口描述
获取已部署的一个或多个加速域名的访问日志。这些日志是2小时或更早时间之前客户端请求所产生的日志。默认情况下，只能查询近14天内的日志。这些日志被切割成多个文件供下载。 要获取加速域名的日志，必须首先通过“创建日志投递配置”接口定义日志格式。注意：必须先创建日志投递配置，访问日志才会被收集。如未创建日志投递配置，则无法下载日志。 日志格式示例: %cltip %rmtuser [%utctime] "%method %url %protocol" %statuscode %rspsize "%referer" "%ua" %rsptime 调用该接口时，将返回如下的日志信息和下载链接: { "logs":[ { "dateFrom":"2021-10-31T00:00:00Z", "dateTo":"2021-10-31T00:29:59Z", "fileSize":105878, "logUrl":"https://abc.example.com/logd/v2/download/0621c8fc885089805kea5f610797ff8ba92bc98c049c2bb308cbdb?traceId=ac6d696c657765625f74657374cf0000018dd01d89e8cd06d3", "hostname":"mydomain.domain.info" } ] } 其中，logUrl字段返回日志文件（经过gzip压缩）的下载链接。下载链接有效期为24个小时。如链接已过期，需重新调用接口获取链接。日志文件内容示例： 9.8.7.6 - [31/Oct/2021:19:59:57 +0000] "GET http://mydomain.domain.info/i/js/tab.js HTTP/1.1" 304 529 "http://mydomain.domain.info/?q=downloads" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/95.0.4638.54 Safari/537.36" 76
- 调用URL： https://open.chinanetcenter.com/cdn/report/logDownload
- 调用方法：POST
调用频率
单用户调用频率：300/5min
Open API在线调试功能提供可视化界面在线调试API、支持生成代码示例、快速检索查看API文档等能力。前往调试
请求参数
Params 参数
| 参数名称 | 描述 |
|---|---|
*startdateString | 查询范围的开始时间，以RFC 3339日期格式表示。必须使用UTC时区指定时间。示例：startdate=2019-10-30T00:00:00Z。 查询开始时间不得早于14天之前。 |
*enddateString | 查询范围的结束时间，以RFC 3339日期格式表示。必须使用UTC时区指定时间。示例：enddate=2019-11-14T00:00:00Z。 |
Body 参数
| 参数名称 | 描述 |
|---|---|
filters | |
hostnames | 指定加速域名。 |
返回参数
Body 参数
| 参数名称 | 描述 |
|---|---|
logs | 日志信息列表。 |
dateFrom | RFC 3339格式的日期，表示日志文件的开始时间。 |
dateTo | RFC 3339格式的日期，表示日志文件的结束时间。 |
fileSize | 取值范围: >= 0
日志文件的大小（MB）。 |
logUrl | 日志文件的下载链接。该文件已使用gzip压缩。 |
hostname | 日志文件对应的加速域名。 |
错误码
| 错误代码（code） | 描述（message） | HTTP状态码 | 语义 |
|---|---|---|---|
| InvalidTimeSpan | The max time span must be no more than 30 days. | 400 | 查询跨度不能超过30天。 |
| InvalidHostname | Please specify the hostname. | 400 | 请指定加速域名。 |
| InvalidDate | Parameter 'startdate' is required. | 400 | startdate参数必填。 |
示例
- 请求示例 复制成功
#!/bin/bash username="example_username" apiKey="example_apiKey" date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"` password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64` curl -i --url "https://open.chinanetcenter.com/cdn/report/logDownload?startdate=2021-10-12T12:00:00Z&enddate=2021-10-18T08:59:59Z" \ -X "POST" \ -u "$username:$password" \ -H "Date: $date" \ -H "Accept: application/json" \ -d '{"filters": {"hostnames": ["myreports.domain.info"]}}'- 返回示例 复制成功
{ "logs": [ { "dateFrom": "2021-10-12T12:00:00Z", "dateTo": "2021-10-12T12:29:59Z", "fileSize": 304, "logUrl": "https://abc.example.com/logd/v2/download/0621c8fc885089805kea5f610797ff8ba92bc98c049c2bb308cbdb?traceId=ac6d696c657765625f74657374cf0000018dd01d89e8cd06d3", "hostname": "myreports.domain.info" }, { "dateFrom": "2021-10-18T08:30:00Z", "dateTo": "2021-10-18T08:59:59Z", "fileSize": 300, "logUrl": "https://abc.example.com/logd/v2/download/0621c8fc885089805kea5f610797ff8ba92bc98c04de2bb308cbdb?traceId=ac6d696c657765625f74657374cf0345018dd01d89e8cd06d3", "hostname": "myreports.domain.info" } ] }