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

DataWorks:ListSemanticJobRuns

最終更新日:Sep 03, 2026

名前を指定して、作成されたノードの実行 Record をページング付きでクエリします。各 Record の JobRunId は特定の実行結果を取得するためにアクティブな値であり、ExecutorJobId は詳細のクエリ、ログの取得、または実行の停止にアクティブな値です。

操作説明

シナリオ

セマンティックタスクの過去の実行 Record をページネーション付きで表示し、各送信の実行 ID、エグゼキュータタスク ID、ステータス、および時間情報を取得します。

手順

  1. CreateSemanticJob.Data.Name または ListSemanticJobs のタスク名を JobName として使用します。

  2. PageNumber と PageSize を使用して、Record をページごとに読み取ります。

  3. Record から JobRunId を使用して DownloadSemanticResults を呼び出し、ExecutorJobId を使用して詳細、ログ、または停止オペレーションを呼び出します。

開始する前に

ページネーションはデフォルトで 1 ページ目から始まります。各ページには最大値 200 件の Record が含まれます。

今すぐお試しください

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

テスト

RAM 認証

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

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

JobName

string

必須

タスク名。CreateSemanticJob 応答の Data.Name 値、または ListSemanticJobs リスト項目の Name 値を使用します。

semantic-job-demo

PageNumber

integer

任意

ページ番号。1 から始まります。このパラメーターが指定されていないか、0 以下の値に設定されている場合、1 ページ目が返されます。

1

PageSize

integer

任意

1 ページあたりに返す実行 Record の数。このパラメーターが指定されていないか、0 以下の値にセットされている場合、デフォルト値 50 が使用されます。最大値: 200。

50

各リクエストフィールドの説明に基づいてリクエストパラメーターを構築します。

レスポンスフィールド

フィールド

型

説明

例

object

実行 Record のページングクエリの標準応答。Data.JobRuns の各項目は、コミットされた実行に対応します。

RequestId

string

リクエスト ID。この ID を使用してログを特定し、問題のトラブルシューティングを行えます。

676271D6-53B4-57BE-89FA-72F7AE1418DF

Success

boolean

リクエストが成功したかどうかを示します。

Data

object

ページネーションされた実行 Record の結果。JobRunId を使用して特定の実行結果をダウンロードし、ExecutorJobId を使用して詳細をクエリ、ログを取得、または実行を停止できます。

TotalCount

integer

現在のタスク条件に一致する実行 Record の総数。

1

PageNumber

integer

返されるページのページ番号。1 から始まります。

1

PageSize

integer

現在の応答における 1 ページあたりの Record 数。

50

JobRuns

array<object>

実行 Record のリスト。

object

単一のセマンティックタスク実行の Record。

JobRunId

string

セマンティックタスク実行 ID。この実行の結果をダウンロードするには、この値を DownloadSemanticResults の JobRunId パラメーターに渡します。

01H00000000000000000000000

ExecutorJobId

string

エグゼキュータタスク ID。この値を GetSemanticJobDetail、GetSemanticJobLog、または KillSemanticJob の ExecutorJobId パラメーターに渡します。

exec-job-demo

JobName

string

この実行が属するタスクの名前。この値を使用して、タスクの再実行、実行 Record のクエリ、または結果のダウンロードを行えます。

semantic-job-demo

UserId

string

この実行を送信したユーザーの ID。

user-demo

GmtCreate

integer

実行 Record が作成された時間。値はミリ秒単位の UNIX タイムスタンプです。

1700000000000

各応答フィールドの意味と後続の呼び出しとの関係については、個々のフィールドの説明を参照してください。

例

成功レスポンス

JSONJSON

{
  "RequestId": "676271D6-53B4-57BE-89FA-72F7AE1418DF",
  "Success": false,
  "Data": {
    "TotalCount": 1,
    "PageNumber": 1,
    "PageSize": 50,
    "JobRuns": [
      {
        "JobRunId": "01H00000000000000000000000",
        "ExecutorJobId": "exec-job-demo",
        "JobName": "semantic-job-demo",
        "UserId": "user-demo",
        "GmtCreate": 1700000000000
      }
    ]
  }
}

エラーコード

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

変更履歴

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