刷新历史查询

最近更新时间:2019-10-31 17:23:25

接口描述

本接口(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
            }
        ]
    }
}