分頁查詢指定中繼資料採集器的執行記錄,並可按時間範圍和執行狀態篩選。
介面說明
使用場景
分頁查詢指定中繼資料採集器最近 30 天內的執行記錄,並可按執行開始時間和狀態篩選。
推薦流程
使用
ListCrawlers查詢採集器 ID。呼叫本介面查詢執行記錄和工作執行個體 ID。
對執行、停止等非同步操作,以本介面返回的最終狀態為準。
版本要求
需要購買 DataWorks 基礎版及以上版本才能使用。
注意事項
未指定時間範圍時,預設查詢當前時間向前 30 天。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求文法
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
}
]
}
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。