API中心
概览
API-Key Authentication
AK/SK Authentication
应用性能管理
边缘应用
CDN Pro
边缘云主机
访问控制
互动直播
流媒体直播
流媒体点播
云直播
低延时直播
云点播
API Shield
Application Shield
Web Application Firewall
Flood Shield
Cloud Security 2.0
Bot Shield
Flood Shield 2.0
动态加速
静态加速
CloudDNS
对象存储
本地存储
证书管理
内容管理
文件预取
推荐-查询文件预取操作记录
推荐-预取文件
缓存刷新
IP查询
云监控
日志下载
其他

推荐-查询文件预取操作记录

更新时间:2025-04-09 16:56:59

查询预取任务的执行状态,可查看是否已经全网执行生效。

  • 单用户调用频率:1/5min
  • 适用产品:内容管理

请求参数

Body 参数

参数名称描述
startTimeString
查询的任务创建开始时间,如 2017-01-10 06:33:26,不允许查询3天之前的任务
endTimeString
查询的任务创建结束时间,如 2017-01-10 23:33:26 1)查询跨度不能超过1天;
itemIdString
表示任务单次提交多个url时任务的唯一标识。 按批次查询任务,如单次提交10条url文件预取,提交成功后内容管理系统将返回一个itemId在响应消息里。 itemId 和 查询起止时间不能同时为空。
urlString
需要预取的文件完整访问路径(url),单次查询只允许输入一条url
statusString
任务状态,允许执行任务状态过滤查询结果,支持查询的状态有: 1、success 2、failure
pageNoString
请求页数,缺省情况下,默认为1
pageSizeString
每页显示的条数,缺省情况下,默认值为20

返回参数

Body 参数

参数名称描述
countInteger
表示本次查询结果的数量,如有10个任务符合查询条件,则count的值为10
CodeInteger
任务提交后,系统的响应码,0表示失败,1表示成功
MessageString
表示任务提交后,系统的响应消息
pageNoInteger
任务查询结果的总页数
pageSizeInteger
每页显示多少条预取文件的任务数据
resultDetailList
任务结果的集合
beginTimeString
内容管理系统开始同步文件的时间
createTimeString
内容管理系统接收预取任务成功并创建预取任务的时间
finishTimeString
内容管理系统执行预取完成的时间
rateString
执行文件预取任务的成功率,如98%,则值为98
statusString
预取文件的任务状态: success:表示文件预取的任务执行成功 failure:表示文件预取的任务执行失败 wait:表示文件预取的任务正在排队中 run:表示文件预取的任务正在执行中
urlString
要预取的文件url

错误码

错误代码(code)描述(message)HTTP状态码语义
1success200成功
0parse json error200解析json出错
0username is invalid200用户名无效(用户名为空或者用户名不允许推送)
0startTime or endTime must not be empty200开始时间或结束时间不允许为空
0query create time should not before 3 days200不允许查询3天之前的任务
0query time error200时间格式出错
0endTime should not before startTime200查询的结束时间不能早于开始时间
0page size error200页面大小不能为负或者大于1000
0page no error200页码不能为负
0task status error,eg: init wait run success failure200查询的状态出错

示例

JSON
XML
JSON
请求示例
复制代码
#!/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://api.cdnetworks.com/ccm/fetch/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",
                    "rate": "100",
                    "status": "success",
                    "url": "http: //vodtest.lxdns.com/testdsfsdf1"
                    },
                    {
                    "beginTime": "2017-01-11 16:17:03",
                    "createTime": "2017-01-11 16:17:03",
                    "finishTime": "2017-01-11 16:17:04",
                    "rate": "100",
                    "status": "success",
                    "url": "https://vodtest.lxdns.com/testdsfsdf1"
                    }
                   ]
}

目录

  • 请求参数
  • 返回参数
  • 错误码
  • 示例
本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!