日志下载链接

最近更新时间:2020-03-06 14:41:55

我的收藏

接口描述

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

入参说明

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见 公共请求参数 页面。其中,此接口的 Action 字段为 GetCdnLogList。
参数名称
是否必选
类型
描述
host
String
要查询日志的域名
startDate
String
查询起始时间,格式为:2016-12-30 00:00:00
endDate
String
查询结束时间,格式为:2016-12-30 01:00:00

出参说明

参数名称
类型
描述
code
Int
公共错误码,0表示成功,其他值表示失败。<br/>详见错误码页面 公共错误码
message
String
模块错误信息描述,与接口相关。
codeDesc
String
英文错误信息,或业务侧错误码。<br/>详见错误码页面 业务错误码
data
Array
结果数据,详细说明见下文

详细说明

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.com
startDate:2016-12-30 00:00:01
endDate: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"
},
...
]
}
}