全部產品
Search
文件中心

DataWorks:ListCrawlerRuns

更新時間:Sep 03, 2026

分頁查詢指定中繼資料採集器的執行記錄,並可按時間範圍和執行狀態篩選。

介面說明

使用場景

分頁查詢指定中繼資料採集器最近 30 天內的執行記錄,並可按執行開始時間和狀態篩選。

推薦流程

  1. 使用 ListCrawlers 查詢採集器 ID。

  2. 呼叫本介面查詢執行記錄和工作執行個體 ID。

  3. 對執行、停止等非同步操作,以本介面返回的最終狀態為準。

版本要求

需要購買 DataWorks 基礎版及以上版本才能使用。

注意事項

未指定時間範圍時,預設查詢當前時間向前 30 天。

調試

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

調試

授權資訊

當前API暫無授權資訊透出。

請求文法

POST  HTTP/1.1

請求參數

名稱

類型

必填

描述

樣本值

Id

integer

是

中繼資料採集器 ID。您可以透過 ListCrawlers 查詢。

1234

StartTimeFrom

integer

否

執行開始時間下界,毫秒級 Unix 時間戳記。取值必須位於最近 30 天內;未傳入時預設為當前時間前 30 天。

1710239005403

StartTimeTo

integer

否

執行開始時間上界,毫秒級 Unix 時間戳記。取值必須位於最近 30 天內;未傳入時預設為當前時間。

1710325405403

Status

string

否

執行狀態。取值:WAITING、RUNNING、SUCCESS、ERROR、SHUTDOWN。

SUCCESS

PageNumber

integer

否

分頁頁碼,從 1 開始,預設值為 1。

1

PageSize

integer

否

每頁項目數,預設值為 20,最大值為 100。

20

StartTimeFrom 和 StartTimeTo 使用毫秒級 Unix 時間戳記,必須位於最近 30 天內,且 StartTimeFrom 不能晚於 StartTimeTo。

返回參數

名稱

類型

描述

樣本值

object

返回結果。

RequestId

string

請求 ID。用於定位日誌,排查問題。

9252F32F-D855-549E-8898-61CF5A733050

Success

boolean

請求是否成功。

PagingInfo

object

分頁資訊。

TotalCount

integer

符合查詢條件的記錄總數。

1

PageNumber

integer

當前頁碼。

1

PageSize

integer

每頁項目數。

20

CrawlerRuns

array<object>

中繼資料採集器執行記錄清單。

object

單筆中繼資料採集器執行記錄。

Status

string

SUCCESS

TaskInstanceId

integer

1234

StartedTime

integer

1710239005403

FinishedTime

integer

1710239065403

Duration

number

60

TotalTableCount

integer

42

CrawlerRuns 返回當前頁執行記錄;可以使用 TaskInstanceId 關聯一次執行。

樣本

正常返回樣本

JSON格式

{
  "RequestId": "9252F32F-D855-549E-8898-61CF5A733050",
  "Success": false,
  "PagingInfo": {
    "TotalCount": 1,
    "PageNumber": 1,
    "PageSize": 20,
    "CrawlerRuns": [
      {
        "Status": "SUCCESS",
        "TaskInstanceId": 1234,
        "StartedTime": 1710239005403,
        "FinishedTime": 1710239065403,
        "Duration": 60,
        "TotalTableCount": 42
      }
    ]
  }
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情。