閱讀1018 返回首頁    go windows

查詢刷新操作記錄__刷新預熱接口_API 手冊_CDN-阿裏雲

描述

查詢刷新、預熱狀態，是否在全網生效。

  • 支持根據任務ID查詢、URL查詢
  • taskid與objectpath都不指定，默認查7天內，第一頁的數據（20條）
  • Taskid與objectpath可以同時指定，邏輯與的關係
  • 隻可查詢7天內的數據

請求參數

參數 類型 必要 描述
Action String 是 操作接口名，係統規定參數
取值：DescribeRefreshTasks
TaskId String 否 按任務Id查詢刷新狀態
ObjectPath String 否 按路徑查詢，準確匹配
PageSize Integer 否 分頁大小，默認20，最大50 取值：1~50之前的任意整數
PageNumber Integer 否 取得第幾頁 取值範圍為：1~100000

返回參數

名稱 類型 描述
Tasks Struct TaskItem組成的Task任務列表。
PageSize Integer 整頁大小
PageNumber Integer 頁碼
TotalCount Integer 總條數

TaskItem 子節點

名稱 類型 描述
TaskId String 任務Id。
ObjectPath String 刷新對象路徑
Status String 狀態，值分別是Complete(完成)、Refreshing(刷新中)、Failed(刷新失敗)、Pending(等待刷新)
Process String 進度百分比
CreationTime DateTime 任務對象創建時間，UTC時間
Description String 刷新預熱失敗返回錯誤描述，目前包含三種錯誤”Internal Error” “Origin Timeout” “Origin Return StatusCode 5XX”

特定錯誤碼

ErrorCode 錯誤碼 Message 錯誤信息 HTTP 狀態
Throttling Request was denied due to request throttling. 503 請求被流量控製限製
OperationDenied Your account does not open CDN service yet. 403 未開通CDN服務
OperationDenied Your CDN service is suspended. 403 CDN服務已被停止
InvalidTaskId.Malformed Specified TaskId is malformed. 400 TaskId格式錯誤

公共錯誤碼請查看

示例

請求示例：

  1. https://cdn.aliyuncs.com?&Action=DescribeRefreshTasks&ObjectPath=&PageNumber=1&PageSize=10&<公共請求參數>

返回示例：

JSON格式：

  1. {
  2.     "Tasks" : {
  3.         "CDNTask" : [{
  4.                 "CreationTime" : "2014-11-27T08:23:22Z",
  5.                 "ObjectPath" : "https://news.ifeng.com/1.txt",
  6.                 "Status" : "Complete",
  7.                 "TaskId" : "704225667"
  8.             }, {
  9.                 "CreationTime" : "2014-11-27T08:18:38Z",
  10.                 "ObjectPath" : "https://news.ifeng.com/1.txt",
  11.                 "Status" : "Complete",
  12.                 "TaskId" : "704222904"
  13.             }, {
  14.                 "CreationTime" : "2014-11-27T07:58:58Z",
  15.                 "ObjectPath" : "https://news.ifeng.com/static/",
  16.                 "Status" : "Complete",
  17.                 "TaskId" : "704211692"
  18.             }, {
  19.                 "CreationTime" : "2014-11-27T07:58:31Z",
  20.                 "ObjectPath" : "https://news.ifeng.com/static/1.png",
  21.                 "Status" : "Complete",
  22.                 "TaskId" : "704211414"
  23.             }, {
  24.                 "CreationTime" : "2014-11-27T07:56:54Z",
  25.                 "ObjectPath" : "https://news.ifeng.com/static/",
  26.                 "Status" : "Complete",
  27.                 "TaskId" : "704210512"
  28.             }, {
  29.                 "CreationTime" : "2014-11-27T07:56:42Z",
  30.                 "ObjectPath" : "https://news.ifeng.com/static/1.png",
  31.                 "Status" : "Complete",
  32.                 "TaskId" : "704210368"
  33.             }, {
  34.                 "CreationTime" : "2014-11-27T07:56:11Z",
  35.                 "ObjectPath" : "https://news.ifeng.com/static/1.png",
  36.                 "Status" : "Complete",
  37.                 "TaskId" : "704210004"
  38.             }, {
  39.                 "CreationTime" : "2014-11-27T04:06:27Z",
  40.                 "ObjectPath" : "https://haitao.smzdm.com/1.txt",
  41.                 "Status" : "Complete",
  42.                 "TaskId" : "704081031"
  43.             }
  44.         ]
  45.     },
  46.     "PageNumber" : 1,
  47.     "PageSize" : 10,
  48.     "TotalCount" : 8,
  49.     "RequestId" : "174F6032-AA26-470D-B90E-36F0EB205BEE"
  50. }

XML格式：

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <DescribeRefreshTasksResponse>
  3.   <Tasks>
  4.     <CDNTask>
  5.       <CreationTime>2014-11-27T08:23:22Z</CreationTime>
  6.       <ObjectPath>https://news.ifeng.com/1.txt</ObjectPath>
  7.       <Status>Complete</Status>
  8.       <TaskId>704225667</TaskId>
  9.     </CDNTask>
  10.     <CDNTask>
  11.       <CreationTime>2014-11-27T08:18:38Z</CreationTime>
  12.       <ObjectPath>https://news.ifeng.com/1.txt</ObjectPath>
  13.       <Status>Complete</Status>
  14.       <TaskId>704222904</TaskId>
  15.     </CDNTask>
  16.     <CDNTask>
  17.       <CreationTime>2014-11-27T07:58:58Z</CreationTime>
  18.       <ObjectPath>https://news.ifeng.com/static/</ObjectPath>
  19.       <Status>Complete</Status>
  20.       <TaskId>704211692</TaskId>
  21.     </CDNTask>
  22.     <CDNTask>
  23.       <CreationTime>2014-11-27T07:58:31Z</CreationTime>
  24.       <ObjectPath>https://news.ifeng.com/static/1.png</ObjectPath>
  25.       <Status>Complete</Status>
  26.       <TaskId>704211414</TaskId>
  27.     </CDNTask>
  28.     <CDNTask>
  29.       <CreationTime>2014-11-27T07:56:54Z</CreationTime>
  30.       <ObjectPath>https://news.ifeng.com/static/</ObjectPath>
  31.       <Status>Complete</Status>
  32.       <TaskId>704210512</TaskId>
  33.     </CDNTask>
  34.     <CDNTask>
  35.       <CreationTime>2014-11-27T07:56:42Z</CreationTime>
  36.       <ObjectPath>https://news.ifeng.com/static/1.png</ObjectPath>
  37.       <Status>Complete</Status>
  38.       <TaskId>704210368</TaskId>
  39.     </CDNTask>
  40.     <CDNTask>
  41.       <CreationTime>2014-11-27T07:56:11Z</CreationTime>
  42.       <ObjectPath>https://news.ifeng.com/static/1.png</ObjectPath>
  43.       <Status>Complete</Status>
  44.       <TaskId>704210004</TaskId>
  45.     </CDNTask>
  46.     <CDNTask>
  47.       <CreationTime>2014-11-27T04:06:27Z</CreationTime>
  48.       <ObjectPath>https://haitao.smzdm.com/1.txt</ObjectPath>
  49.       <Status>Complete</Status>
  50.       <TaskId>704081031</TaskId>
  51.     </CDNTask>
  52.   </Tasks>
  53.   <PageNumber>1</PageNumber>
  54.   <PageSize>10</PageSize>
  55.   <TotalCount>8</TotalCount>
  56.   <RequestId>13DF2E2F-FBF8-4E1C-9222-98141795443D</RequestId>
  57. </DescribeRefreshTasksResponse>

最後更新：2016-11-23 17:16:03

  上一篇：go 預熱緩存__刷新預熱接口_API 手冊_CDN-阿裏雲
  下一篇：go 查詢操作餘量__刷新預熱接口_API 手冊_CDN-阿裏雲