接口描述
GetCdnRefreshLog 查询提交的刷新URL、刷新目录任务执行情况。
请求域名:cdn.api.qcloud.com
注意事项:
刷新纪录保存30天
支持精确到秒的时间区间查询
支持根据提交时反馈的任务 taskId 进行查询
支持根据域名查询刷新记录
支持根据 url 查询刷新记录
调用频次限制为1000次/分钟
接口已支持子账号调用,权限配置可参考权限 配置示例
入参说明
参数名称 | 是否必选 | 类型 | 描述 |
startDate | 否 | String | 查询开始时间,如 2017-11-29 00:00:00 |
endDate | 否 | String | 查询结束时间,如 2017-11-29 00:05:00 |
taskId | 否 | String | 根据提交刷新URL任务返回的 task_id 查询 |
host | 否 | String | 需要查询的域名 |
url | 否 | String | 需要查询的URL(可为空) |
详细说明
startDate&endDate 与 taskId 必须选择一种模式进行查询;
若同时填充 startDate&endDate 和 taskId,若该taskId并非在此时间区间内提交,则会提示“日期不合法”。
出参说明
详细说明
data
参数名称 | 类型 | 描述 |
logs | Array | 日志详情 |
total | Int | 刷新次数 |
logs
参数名称 | 类型 | 描述 |
id | Int | 编号 |
app_id | Int | 用户App ID |
project_id | Int | 项目ID |
host | String | 域名 |
type | Int | 刷新类型<br/>0:代表URL刷新<br/>1:代表目录刷新 |
status | Int | 刷新结果<br/>1:表示刷新成功<br/>0:表示刷新中<br/>若为负数,表示刷新失败 |
url_list | Array | 本次刷新时提交的URL列表 |
datetime | String | 提交时间 |
调用示例
示例参数
startDate: 2017-02-06 19:00:00endDate: 2017-02-06 19:40:00
GET 请求
GET 请求需要将所有参数都加在 URL 后:
https://cdn.api.qcloud.com/v2/index.php?Action=GetCdnRefreshLog&SecretId=XXXXXXXXXXXXXXXXXXXXXXXXXXX&Timestamp=1462422547&Nonce=12345678&Signature=XXXXXXXXXXXXXXXXXXXXXXXXX&startDate=2017-02-06+19%3A00%3A00&endDate=2017-02-06+19%3A40%3A00
POST 请求
POST 请求时,参数填充在 HTTP Request-body 中,请求地址:
https://cdn.api.qcloud.com/v2/index.php
参数支持 form-data、x-www-form-urlencoded 等格式,参数数组如下:
array ('Action' => 'GetCdnRefreshLog','SecretId' => 'XXXXXXXXXXXXXXXXXXXXXXXXXXXX','Timestamp' => 1462782282,'Nonce' => 123456789,'Signature' => 'XXXXXXXXXXXXXXXXXXXXXXXX','startDate' => '2017-02-06 19:00:00',"endDate" => '2017-02-06 19:40:00')
结果示例
{"retcode": 0,"errmsg": "ok","code": 0,"message": "","codeDesc": "Success","data": {"logs": [{"id": 6182538,"app_id": 123456,"project_id": 0,"host": "www.test.com","type": 0,"status": 1,"url_list": ["http://www.test.com/Content/image/test.png"],"datetime": "2017-02-06 19:39:59"}"total": 1}}