創建刷新任務
更新時間 2025-07-02 14:42:58
最近更新時間: 2025-07-02 14:42:58
分享文章
接口描述:調用本接口創建刷新任務
請求方式:post
請求路徑:/refresh-task/create-refresh-task
使用說明: 單個用戶一分鐘限制調用10000次,并發不超過100
請求參數說明:
| 參數 | 類型 | 是否必傳 | 名稱 | 描述 |
|---|---|---|---|---|
| task_type | int | 是 | 刷新類型 | 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都刷新。 |
| values | list< string> | 是 | 刷新參數值 | 刷新類型為url時單次最多1000條,類型為dir和re時單次最多50條。每條任務要以//或//開頭,目錄刷新要以/結尾,正則刷新僅支持輸入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 |
示例:
請求路徑://cdnapi-global.ctapi.daliqc.cn/refresh-task/create-refresh-task
示例1:
請求參數:
{
"task_type": 1,
"values": [
"//xxx.daliqc.cn/xxx/xxx1.png",
"//xxx.daliqc.cn/xxx/xxx2.png"
]
}返回結果:
{
"code": 100000,
"message": "success",
"submit_id": "166790352031999",
"result": [
{
"task_id": "166790352031261099",
"url": "//xxx.daliqc.cn/xxx1.png"
},
{
"task_id": "166790352031261088",
"url": "//xxx.daliqc.cn/xxx2.png"
}
]
}錯誤碼請參考:參數code和message含義