調用DescribeRefreshTaskById查詢重新整理狀態和預熱狀態是否在全網生效。

说明
  • 支援查詢3天內（包含3天）的資料。
  • 單使用者調用頻率為30次/秒。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

請求參數

名稱 類型 是否必選 樣本值 描述
Action String 是 DescribeRefreshTaskById

系統規定參數。取值： DescribeRefreshTaskById 。

TaskId String 是 12345678

待查詢的任務ID。

您可以調用 RefreshObjectCaches 介面，從其傳回值中擷取重新整理預熱的任務ID，並通過任務ID查詢來源站點資源的重新整理狀態。

支援同時傳入多個任務ID，多個任務ID之間用英文逗號（,）分隔，最多支援同時傳入10個任務ID。

返回資料

名稱 類型 樣本值 描述
RequestId String E0C2EF95-B1EC-4C93-855E-2059A7DA2B7B

請求ID。
Tasks Array of CDNTask

工作清單。
CreationTime String 2020-08-03T08:54:23Z

任務對象建立時間，使用UTC時間表示。
Description String Internal Error

重新整理預熱失敗後返回的錯誤描述。取值：

  • Internal Error ：內部錯誤。
  • Origin Timeout ：來源站點響應逾時。
  • Origin Return StatusCode 5XX ：來源站點響應5xx錯誤碼。
ObjectPath String http://example.com/abc.jpg

重新整理對象的路徑。
ObjectType String file

任務類型。取值：

  • file ：單檔案重新整理。
  • directory ：目錄重新整理。
  • preload ：單檔案預熱。
Process String 100%

任務完成進度百分比。
Status String Complete

任務狀態。取值：

  • Complete ：已完成。
  • Pending ：等待重新整理。
  • Refreshing ：重新整理中。
  • Failed ：重新整理失敗。
TaskId String 12345678

查詢到的任務ID。
TotalCount Long 2

任務總個數。

樣本

請求樣本


    http(s)://cdn.aliyuncs.com/?Action=DescribeRefreshTaskById &TaskId=12345678 &<公用請求參數>

正常返回樣本

XML 格式 


    <DescribeRefreshTaskByIdResponse> <RequestId>E0C2EF95-B1EC-4C93-855E-2059A7DA2B7B</RequestId> <Tasks> <CreationTime>2020-08-03T08:54:23Z</CreationTime> <Description></Description> <ObjectPath>http://example.com/abc.jpg</ObjectPath> <ObjectType>file</ObjectType> <Process>100%</Process> <Status>Complete</Status> <TaskId>12345678</TaskId> </Tasks> <Tasks> <CreationTime>2020-08-03T09:12:44Z</CreationTime> <Description></Description> <ObjectPath>http://example.com/bcd.jpg</ObjectPath> <ObjectType>file</ObjectType> <Process>99.37%</Process> <Status>Refreshing</Status> <TaskId>23456789</TaskId> </Tasks> <TotalCount>2</TotalCount> </DescribeRefreshTaskByIdResponse>

JSON 格式 


    { "RequestId": "E0C2EF95-B1EC-4C93-855E-2059A7DA2B7B", "Tasks": [ { "CreationTime": "2020-08-03T08:54:23Z", "Description": "", "ObjectPath": "http://example.com/abc.jpg", "ObjectType": "file", "Process": "100%", "Status": "Complete", "TaskId": "12345678" }, { "CreationTime": "2020-08-03T09:12:44Z", "Description": "", "ObjectPath": "http://example.com/bcd.jpg", "ObjectType": "file", "Process": "99.37%", "Status": "Refreshing", "TaskId": "23456789" } ], "TotalCount": 2 }

錯誤碼

訪問 錯誤中心查看更多錯誤碼。