接口描述
本接口(GetFlushLog) 查询提交的刷新 URL、刷新目录任务执行情况。
请求域名:dsa.api.qcloud.com
可支持配置
- 查询提交的刷新 URL 任务执行情况
- 查询提交的刷新目录任务执行情况
说明:该接口调用频次上限为100次/分钟,超出上限则会返回错误,请勿高频调用
输入参数
以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,详情请参见 公共请求参数 。
其中,此接口的 Action 字段为 GetFlushLog。
参数名称 | 是否必选 | 类型 | 描述 |
---|---|---|---|
type | 是 | Int | 刷新类型。 0:URL刷新 1:目录刷新 |
date | 否 | String | 指定查询的日期。例:2019-08-12 |
taskId | 否 | String | 指定查询的任务 ID |
keyword | 否 | String | 查询关键字 |
status | 否 | Int | 任务状态。 -1:失败 1:刷新中 2:完成 |
offset | 否 | Int | 查询起始偏移量,从0开始。传入10表示从第10条开始 |
limit | 否 | Int | 查询限制条数 |
输出参数
参数名称 | 类型 | 描述 |
---|---|---|
total | Int | 总数,用于分页 |
logs | Log 数组 | 刷新记录 |
Log 定义
参数名称 | 类型 | 描述 |
---|---|---|
task_id | String | 任务 ID |
url | String | 刷新 URL |
type | Int | 刷新类型。 0:URL 刷新 1:目录刷新变更资源 2:目录刷新所有资源 |
datetime | String | 刷新时间 |
status | Int | 任务状态。 -1:失败 1:刷新中 2:完成 |
调用示例
查询2019-9-20日 URL 刷新记录
GET 请求
GET 请求需要将所有参数都加在 URL 后:
https://dsa.api.qcloud.com/v2/index.php?
Action=GetFlushLog
&SecretId=xxxxxxxxxxxxxxxxxxxxxxxxx
&Nonce=44
&Timestamp=1572349397
&date=2019-09-20
&type=0
&Signature=xxxxxxxxxxxxxxxxxxxxxxx
POST 请求
POST 请求时,参数填充在 HTTP Request-body 中,请求地址:
https://dsa.api.qcloud.com/v2/index.php
参数支持 form-data、x-www-form-urlencoded 等格式,参数数组如下:
array (
'Action' => 'GetFlushLog',
'SecretId' => 'xxxxxxxxxxxxxxxxxxxxxxxxx',
'Nonce' => 44,
'Timestamp' => 1572349397,
'Signature'=>'xxxxxxxxxxxxxxxxxxxxxxx',
'date' =>'2019-09-20',
'type'=> 0
)
结果示例
{
"code": 0,
"message": "",
"codeDesc": "Success",
"data": {
"total": 2,
"logs": [
{
"task_id": "1572347900707791519",
"url": "http://xxxxxxxxxxxxxx/1.jpg",
"type": 0,
"datetime": "2019-09-20 19:18:20",
"status": 2
},
{
"task_id": "1572347899565885803",
"url": "http://xxxxxxxxxxxxxxxxx /2.jpg",
"type": 0,
"datetime": "2019-09-20 19:18:19",
"status": 2
}
]
}
}