按已建立任務的 Name 分頁查詢其執行記錄;記錄中的 JobRunId 可用於取得指定執行的結果,ExecutorJobId 可用於詳細資訊、日誌與停止。
介面說明
使用場景
分頁檢視一個語意任務的歷史執行記錄,了解每次提交的執行識別碼、執行器任務識別碼、狀態和時間資訊。
呼叫流程
使用
CreateSemanticJob.Data.Name或ListSemanticJobs中的任務名稱作為JobName。透過
PageNumber和PageSize分頁讀取記錄。使用記錄中的
JobRunId呼叫DownloadSemanticResults,使用ExecutorJobId呼叫詳細資訊、日誌或停止介面。
注意事項
分頁預設從第 1 頁開始,單頁最大 200 筆。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| 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
}
]
}
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。