接口描述
GetCdnLogList 获取域名日志下载链接。
请求域名:cdn.api.qcloud.com
Note:
一次仅可查询一个域名的日志下载链接。
默认情况下日志按小时打包,稳定时间约2小时左右。
仅保留30天内的历史日志,若不填充查询起始时间,则默认返回近30天的所有日志下载链接。
日志下载链接的有效期为24小时。
startDate 为查询开始时间,endDate 为查询结束时间,返回为涵盖指定 startDate 和 endDate 区间的日志数据包,假设 startDate = 2016-12-30 00:01:00,endDate = 2016-12-30 02:12:00,则会返回 2016123000、2016123001、2016123002 三个小时的数据包。
若某一个小时未产生访问日志,则不会生成下载链接,也不会返回。
调用频次限制为10000次 / 分钟。
接口已支持子账号调用,权限配置可参考权限 配置示例。
日志下载链接 API_V1 版本:GenerateLogList
入参说明
参数名称 | 是否必选 | 类型 | 描述 |
host | 是 | String | 要查询日志的域名 |
startDate | 否 | String | 查询起始时间,格式为:2016-12-30 00:00:00 |
endDate | 否 | String | 查询结束时间,格式为:2016-12-30 01:00:00 |
出参说明
详细说明
data
参数名称 | 类型 | 描述 |
now | Int | 当前时间,Unix 时间戳 |
list | Array | 日志下载链接列表 |
list
参数名称 | 类型 | 描述 |
date | Int | 日志日期 |
type | Int | 是否有日志<br/>1:有日志<br/>0:无日志 |
name | String | 日志名称,格式为:日期小时-域名<br/>如 2016050301-www.test.com |
link | String | 下载链接 |
调用案例
示例参数
host:www.test.comstartDate:2016-12-30 00:00:01endDate:2016-12-30 05:12:00
GET 请求
GET 请求需要将所有参数都加在 URL 后:
https://cdn.api.qcloud.com/v2/index.php?Action=GetCdnLogList&SecretId=XXXXXXXXXXXXXXXXX&Timestamp=1462430812&Nonce=123456789&Signature=XXXXXXXXXXXXXXXXXXXXX&host=www.test.com&startDate=2016-12-30+00%3A00%3A01&endDate=2016-12-30+05%3A12%3A00
POST 请求
POST请求时,参数填充在 HTTP Request-body 中,请求地址:
https://cdn.api.qcloud.com/v2/index.php
参数支持 form-data、x-www-form-urlencoded 等格式,参数数组如下:
array ('Action' => 'GetCdnLogList','SecretId' => 'XXXXXXXXXXXXXXXXXXX','Timestamp' => 1462865760,'Nonce' => 1058191224,'Signature' => 'XXXXXXXXXXXXXXXXXXXXXXXXXXX','host' => 'www.test.com','startDate' => '2016-12-30 00:00:01','endDate' => '2016-12-30 05:12:00')
结果示例
{"code":0,"message":"","codeDesc": "Success","data":{"now":1483954368,"list":[{"date":2016-12-30,"type":1,"name":"2016123000-www.test.com","link":"http://log-download.cdn.qcloud.com/20161230/00/2016123000-www.test.com.gz?st=XXXXXXXXXXXXXXXXXXXX&e=1483954368"},{"date":2016-12-30,"type":1,"name":"2016123001-www.test.com","link":"http://log-download.cdn.qcloud.com/20161230/01/2016123001-www.test.com.gz?st=XXXXXXXXXXXXXXXXX&e=1483954368"},...]}}