内容管理
查询刷新缓存任务的执行状态,可查看是否已经全网执行生效。
单用户调用频率:10/5min
Open API在线调试功能提供可视化界面在线调试API、支持生成代码示例、快速检索查看API文档等能力。前往调试
参数名称 | 类型 | 必填 | 描述 |
---|---|---|---|
startTime | String | 否 | 任务创建开始时间,格式为yyyy-MM-dd HH:mm:ss;例如 2017-01-10 06:33:26,只能查询3天之内的刷新任务。 |
endTime | String | 否 | 任务创建结束时间,格式为yyyy-MM-dd HH:mm:ss;例如 2017-01-10 06:33:26, |
itemId | String | 否 | 表示任务单次提交多个url时任务的唯一标识。按批次查询任务,如单次提交10条url刷新,提交成功后内容管理系统将返回一个itemId在响应消息里。itemId 和 查询起止时间不能同时为空。 |
url | String | 否 | 需要刷新缓存的url(支持目录、正则、tag、文件),单次调用只允许输入一条url |
status | String | 否 | 任务状态,允许指定任务状态过滤,支持查询的状态有:1)success2)failure3)wait4)run |
pageNo | Integer | 否 | 请求页数,缺省情况下,默认为1 |
pageSize | Integer | 否 | 每页显示的条数,缺省情况下,默认值为20 |
参数名称 | 类型 | 描述 |
---|---|---|
count | Integer | 本次查询结果的数量,如有10个任务符合查询条件,则count的值为10 |
Code | Integer | 任务提交后,系统的响应码,0表示失败,1表示成功 |
Message | String | 任务提交后,系统的响应消息 |
pageNo | Integer | 任务查询结果的总页数 |
pageSize | Integer | 每页显示多少条刷新任务数据 |
resultDetail | List | 任务结果的集合 |
begint32ime | String | 内容管理系统开始执行缓存刷新任务的时间 |
createTime | String | 内容管理系统创建缓存刷新任务的时间 |
finishTime | String | 内容管理系统执行并汇总缓存刷新任务的完成时间 |
rate | String | 执行缓存刷新任务的成功率,如98%,则值为98 |
status | String | 缓存刷新任务执行的状态,有以下几种状态:success:表示刷新文件缓存的任务执行成功 failure:表示刷新文件缓存的任务执行失败 wait:表示刷新缓存的任务正在排队中 run:表示刷新缓存的任务正在执行中 |
url | String | 执行缓存刷新的具体文件或目录 |
isDir | Integer | 刷新任务的操作类型:0:刷新某个具体文件 1:正则文件 2:刷新某个目录下的所有文件 3:刷新某个tag |
错误代码(code) | 描述(message) | HTTP状态码 | 语义 |
---|---|---|---|
0 | endTime should not before startTime | 200 | 查询的结束时间不能早于开始时间 |
0 | page no error | 200 | 页码不能为负 |
0 | page size error | 200 | 页面大小不能为负或者大于1000 |
0 | parse json error | 200 | 解析json出错 |
0 | query create time should not before 3 days | 200 | 不允许查询3天之前的任务 |
0 | query time error | 200 | 时间格式出错 |
0 | startTime or endTime must not be empty | 200 | 开始时间或结束时间不允许为空 |
1 | success | 200 | 查询成功 |
0 | task status error,eg: init wait run success failure | 200 | 查询的状态出错 |
0 | username is invalid | 200 | 用户名无效(用户名为空或者用户名不允许推送) |
#!/bin/bash username="username" apiKey='apiKey' date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"` password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64` curl -i --url "https://open.chinanetcenter.com/ccm/purge/ItemIdQuery" \ -X "POST" \ -u "$username:$password" \ -H "Date:$date" \ -H "Content-Type: application/json" \ -d '{ "startTime":"2017-05-01 00:00:00", "endTime":"2017-05-02 23:59:59", "itemId":"3ff59d129a2c40a39b9be8c9de9975d6", "url":"https://www.test.com/test/test.jpg", "status":"success", "pageNo":1, "pageSize":20 }'
HTTP/1.1 200 OK Content-Type: charset=utf-8; charset=UTF-8 x-cnc-request-id: 23f9abf8-1f4a-498c_1493668625478 Server: xxx Content-Length: 1355 { "count": 282, "Code": 1, "Message":"success", "pageNo": 1, "pageSize": 20, "resultDetail": [ { "beginTime": "2017-01-11 16:17:03", "createTime": "2017-01-11 16:17:03", "finishTime": "2017-01-11 16:17:04", "isDir":0, "rate": "100", "status": "success", "url": "http: //www.abc.com/testdsfsdf1" }, { "beginTime": "2017-01-11 16:17:03", "createTime": "2017-01-11 16:17:03", "finishTime": "2017-01-11 16:17:04", "isDir":1, "rate": "100", "status": "success", "url": "http: //www.abc.com/test/" } ] }