接口描述:调用本接口创建刷新任务
请求方式:post
请求路径:/refresh-task/create-refresh-task
使用说明: 单个用户一分钟限制调用10000次,并发不超过100
请求参数说明:
1(url);2(目录dir);3(正则匹配re) 说明 1.URL刷新会获取提交的URL缓存key进行刷新,即与提交的URL相同缓存key的文件都刷新。 如用户访问URL与缓存key不一样,请提交用户访问URL。 2.目录刷新会获取提交的目录URL缓存key进行刷新(参照URL刷新),即与提交的目录相同缓存key的文件都刷新。 如用户访问目录与缓存key不一样,请提交用户访问目录。根目录刷新任务下发后全部缓存均会过期回源,存在较高业务风险,默认不支持根目录刷新,如确认需要执行根目录刷新,请通过工单提交给天翼云客服。 3.正则刷新会获取提交的正则缓存协议(http/https)及缓存host进行刷新,即与提交的正则相同缓存协议及缓存host都刷新。参数 类型 是否必传 名称 描述 task_type int 是 刷新类型 values list< string> 是 刷新参数值 刷新类型为url时单次最多1000条,类型为dir和re时单次最多50条。每条任务要以http://或https://开头,目录刷新要以/结尾,正则刷新仅支持输入4种正则表达式:[0-9]、[a-z]、[^/]*、.*。 参数 类型 是否必传 名称 描述
返回参数说明:
参数 类型 是否必传 名称及描述 code int 是 状态码 message string 是 描述信息 submit_id string 否 提交id result list< object> 否 返回包含任务id的列表 result[*].task_id string 否 任务id result[*].url string 否 刷新的URL
示例:
请求路径:https://cdnapi-global.ctapi.ctyun.cn/refresh-task/create-refresh-task
示例1:
请求参数:
{ "task_type": 1, "values": [ "http://xxx.ctyun.cn/xxx/xxx1.png", "http://xxx.ctyun.cn/xxx/xxx2.png" ] }
返回结果:
{ "code": 100000, "message": "success", "submit_id": "166790352031999", "result": [ { "task_id": "166790352031261099", "url": "http://xxx.ctyun.cn/xxx1.png" }, { "task_id": "166790352031261088", "url": "http://xxx.ctyun.cn/xxx2.png" } ] }
错误码请参考:参数code和message含义