查询预热任务
更新时间 2025-06-24 14:04:24
最近更新时间: 2025-06-24 14:04:24
接口描述：调用本接口查看预热任务
请求方式：get
请求路径：/preload-task/query-preload-task
使用说明： 单个用户一分钟限制调用10000次，并发不超过100
请求参数说明：
| 参数 | 类型 | 是否必传 | 名称 | 描述 |
|---|---|---|---|---|
| type | int | 否 | 查询方式 | 0（按照时间查询）；1（按照submit_id查询）；2（按照task_id查询）。默认为0 |
| url | string | 否 | 模糊查询 | 比如url为http://www.url.ctyun.cn/1.jpg，那么入参url=com或url=1.jpg可查询到 |
| start_time | int | 否 | 开始时间戳 | 起始时间，时间戳(秒)，type=0时，必填 |
| end_time | int | 否 | 结束时间戳 | 结束时间，时间戳(秒)，type=0时，必填 |
| submit_id | string | 否 | 提交id | 预热提交id，type=1时，必填 |
| task_id | string | 否 | 任务id | 预热任务id，type=2时，必填 |
| page | int | 否 | 页数 | 默认1；当且仅当type=0时有效 |
| page_size | int | 否 | 每页条数 | 默认50， 最大300；当且仅当type=0时有效 |
返回参数说明：
| 参数 | 类型 | 是否必传 | 名称及描述 |
|---|---|---|---|
| code | int | 是 | 状态码 |
| message | string | 是 | 描述信息 |
| total | int | 否 | 总条数 |
| page | int | 否 | 页数 |
| page_size | int | 否 | 本页条数 |
| result | list<objct> | 否 | 返回结果数组 |
| result[*].url | string | 否 | 预取url |
| result[*].submit_time | string | 否 | 提交时间 |
| result[*].status | string | 否 | 任务执行状态,processing(进行中); completed(成功); failed(失败) |
示例：
请求路径：https://cdnapi-global.ctapi.ctyun.cn/preload-task/query-preload-task
请求：https://cdnapi-global.ctapi.ctyun.cn/preload-task/query-preload-task?type=8&start_time=1661500835&end_time=1664179235
返回结果：
{
"code": 10000,
"message": "success",
"total": 1,
"page": 1,
"page_size": 1,
"result": [
{
"submit_time": "2019-05-06 12:00:00.000000",
"url": "http://www.test.ctyun.cn/test/",
"status": "completed"
}
]
}错误码请参考：参数code和message含义
