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

说明
  • 支援根據任務ID或URL查詢。
  • 支援同時傳入 TaskId 和 ObjectPath 參數，如果不指定 TaskId 和 ObjectPath ，預設查詢最近3天內第一頁的資料（20條）。
  • 只可查詢最近3天內的資料。
  • 如果您在OSS控制台開啟了CDN緩衝自動重新整理，則無法通過DescribeRefreshTasks介面查看OSS上的緩衝自動重新整理任務。
  • 單使用者調用頻率為10次/秒。如果您需要更高的調用頻率，請使用僅支援通過任務編號查詢重新整理預熱任務資訊的介面 DescribeRefreshTaskById 。

調試

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

請求參數

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

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

TaskId String 否 1234321

按任務ID查詢重新整理狀態。
ObjectPath String 否 http://example.com/1.txt

按路徑查詢，準確匹配。
PageNumber Integer 否 1

取得第幾頁，取值範圍為： 1 ~ 100000 。

ObjectType String 否 file

任務類型。取值：

  • file ：單檔案重新整理。
  • directory ：目錄重新整理。
  • preload ：單檔案預熱。
说明 當指定 DomainName 或 Status 參數時， ObjectType 參數為必傳參數。
DomainName String 否 example.com

加速網域名稱。僅支援單個查詢，預設查詢所有加速網域名稱。
Status String 否 Complete

任務狀態。取值：

  • Complete ：完成。
  • Refreshing ：重新整理中。
  • Failed ：重新整理失敗。
PageSize Integer 否 20

分頁大小，預設 20 ，最大 100 。取值： 1 ~ 100 。

StartTime String 否 2017-12-21T08:00:00Z

開始時間。日期格式按照ISO8601標記法，並使用UTC時間，格式為yyyy-MM-ddTHH:mm:ssZ。
EndTime String 否 2017-12-22T08:00:00Z

結束時間。日期格式按照ISO8601標記法，並使用UTC時間，格式為yyyy-MM-ddTHH:mm:ssZ。

说明 結束時間需大於起始時間。
ResourceGroupId String 否 rg-acfmyuji4b6r4**

資源群組ID。

返回資料

名稱 類型 樣本值 描述
Tasks Array of CDNTask

工作清單。
CDNTask
TaskId String 704225667

任務ID。
ObjectPath String http://example.com/1.txt

重新整理物件路徑。
Status String Complete

狀態。

  • Complete ：完成。
  • Refreshing ：重新整理中。
  • Failed ：重新整理失敗。
  • Pending ：等待重新整理。
Process String 100%

進度百分比。
ObjectType String file

任務類型。

  • file ：單檔案重新整理。
  • directory ：目錄重新整理。
  • preload ：單檔案預熱。
CreationTime String 2014-11-27T08:23:22Z

任務對象建立時間，UTC時間。
Description String Internal Error

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

  • InternalError ：內部錯誤。
  • OriginTimeout ：來源站點響應逾時。
  • OriginReturnStatusCode 5XX ：來源站點響應5xx錯誤碼。
PageSize Long 1

整頁大小。
PageNumber Long 10

頁碼。
TotalCount Long 2

總條數。
RequestId String 174F6032-AA26-470D-B90E-36F0EB205BEE

請求ID。

樣本

請求樣本

http(s)://cdn.aliyuncs.com/?Action=DescribeRefreshTasks
&ObjectPath=http://example.com/1.txt
&PageNumber=1
&PageSize=10
&<Common request parameters>

正常返回樣本

XML 格式 

<DescribeRefreshTasksResponse>    
      <Tasks>
            <CDNTask>
                  <CreationTime>2014-11-27T08:23:22Z</CreationTime>
                  <ObjectPath>http://example.com/1.txt</ObjectPath>
                  <Status>Complete</Status>
                  <TaskId>704225667</TaskId>
                  <ObjectType>file</ObjectType>
                  <Process>100%</Process>
            </CDNTask>
            <CDNTask>
                  <CreationTime>2014-11-27T08:18:38Z</CreationTime>
                  <ObjectPath>http://aliyundoc.com/1.txt</ObjectPath>
                  <Status>Complete</Status>
                  <TaskId>704222904</TaskId>
                  <ObjectType>file</ObjectType>
                  <Process>100%</Process>
            </CDNTask>
      </Tasks>
      <PageNumber>1</PageNumber>
      <PageSize>10</PageSize>
      <TotalCount>2</TotalCount>
      <RequestId>174F6032-AA26-470D-B90E-36F0EB205BEE</RequestId>
</DescribeRefreshTasksResponse>

JSON 格式 

{
    "Tasks": {
        "CDNTask": [
            {
            "CreationTime": "2014-11-27T08:23:22Z",
            "ObjectPath": "http://example.com/1.txt",
            "Status": "Complete",
            "TaskId": "704225667",
            "ObjectType": "file",
            "Process": "100%"
        }, {
            "CreationTime": "2014-11-27T08:18:38Z",
            "ObjectPath": "http://aliyundoc.com/1.txt",
            "Status": "Complete",
            "TaskId": "704222904",
            "ObjectType": "file",
            "Process": "100%"
        }
      ]
    },
    "PageNumber": 1,
    "PageSize": 10,
    "TotalCount": 2,
    "RequestId": "174F6032-AA26-470D-B90E-36F0EB205BEE"
}

錯誤碼

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