すべてのプロダクト
Search
ドキュメントセンター

DataWorks:ListCrawlerRuns

最終更新日:Sep 03, 2026

指定されたメタデータクローラーの実行 Record をページングして照会します。時間範囲および実行ステータスによるフィルタリングも可能です。

操作説明

シナリオ

過去 30 日間の指定されたメタデータクローラーの実行 Record をページングして照会します。実行開始時刻およびステータスによるフィルタリングも可能です。

推奨ワークフロー

  1. ListCrawlers を呼び出してクローラー ID を取得します。

  2. この操作を呼び出して、実行 Record およびノードインスタンス ID をクエリします。

  3. 実行中や停止などの非同期操作については、この操作で返される最終ステータスを信頼できるソースとして使用してください。

エディション要件

DataWorks Basic Edition 以上のエディションが必須です。

注意事項

時間範囲が指定されていない場合、システムはデフォルトで過去 30 日間の Record を照会します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエスト構文

POST  HTTP/1.1

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

Id

integer

必須

メタデータクローラーの ID。ListCrawlers を呼び出して ID を取得できます。

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

クエリ条件を満たす Record の総数。

1

PageNumber

integer

現在のページ番号。

1

PageSize

integer

ページサイズ。

20

CrawlerRuns

array<object>

メタデータクローラー実行 Record のリスト。

object

単一のメタデータクローラー実行 Record。

Status

string

SUCCESS

TaskInstanceId

integer

1234

StartedTime

integer

1710239005403

FinishedTime

integer

1710239065403

Duration

number

60

TotalTableCount

integer

42

CrawlerRuns は現在のページの実行 Record を返します。TaskInstanceId を使用して特定の実行を関連付けることができます。

例

成功レスポンス

JSONJSON

{
  "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
      }
    ]
  }
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。