全部產品
Search
文件中心

DataWorks:ListSemanticJobRuns

更新時間:Sep 03, 2026

按已建立任務的 Name 分頁查詢其執行記錄;記錄中的 JobRunId 可用於取得指定執行的結果,ExecutorJobId 可用於詳細資訊、日誌與停止。

介面說明

使用場景

分頁檢視一個語意任務的歷史執行記錄,了解每次提交的執行識別碼、執行器任務識別碼、狀態和時間資訊。

呼叫流程

  1. 使用 CreateSemanticJob.Data.Name 或 ListSemanticJobs 中的任務名稱作為 JobName。

  2. 透過 PageNumber 和 PageSize 分頁讀取記錄。

  3. 使用記錄中的 JobRunId 呼叫 DownloadSemanticResults,使用 ExecutorJobId 呼叫詳細資訊、日誌或停止介面。

注意事項

分頁預設從第 1 頁開始,單頁最大 200 筆。

調試

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

調試

授權資訊

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

請求參數

名稱

類型

必填

描述

樣本值

JobName

string

是

任務名稱,使用 CreateSemanticJob 回應的 Data.Name 或 ListSemanticJobs 清單項目的 Name。

semantic-job-demo

PageNumber

integer

否

頁碼,從 1 開始;省略或小於等於 0 時按第 1 頁處理。

1

PageSize

integer

否

每頁傳回的執行記錄數;省略或小於等於 0 時預設 50,最大 200。

50

請根據各請求欄位的說明建構呼叫參數。

返回參數

名稱

類型

描述

樣本值

object

分頁查詢執行記錄的標準回應。Data.JobRuns 中每項對應一次已提交執行。

RequestId

string

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

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

Success

boolean

請求是否成功。

Data

object

執行記錄分頁結果。使用其中的 JobRunId 下載指定執行結果,使用 ExecutorJobId 查詢詳細資訊、日誌或停止執行。

TotalCount

integer

符合目前任務條件的執行記錄總數。

1

PageNumber

integer

本次傳回的頁碼,從 1 開始。

1

PageSize

integer

本次傳回的每頁記錄數。

50

JobRuns

array<object>

執行記錄清單。

object

一次語意任務執行的記錄。

JobRunId

string

語意任務執行識別碼;傳給 DownloadSemanticResults 的 JobRunId 可下載該次執行結果。

01H00000000000000000000000

ExecutorJobId

string

執行器任務識別碼;傳給 GetSemanticJobDetail、GetSemanticJobLog 或 KillSemanticJob 的 ExecutorJobId。

exec-job-demo

JobName

string

執行所屬任務名稱;可用於再次執行、查詢執行記錄或下載結果。

semantic-job-demo

UserId

string

提交本次執行的使用者識別碼。

user-demo

GmtCreate

integer

執行記錄建立時間,單位為毫秒的 Unix 時間戳記。

1700000000000

回應欄位含義和後續呼叫關係請參閱各欄位說明。

樣本

正常返回樣本

JSON格式

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

錯誤碼

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

變更歷史

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