ListSemanticJobRuns - 查询语义任务运行记录-大数据开发治理平台 DataWorks(DataWorks)-阿里云帮助中心

按已创建任务的 Name 分页查询其运行记录；记录中的 JobRunId 可用于获取指定运行的结果，ExecutorJobId 可用于详情、日志与停止。

接口说明

使用场景

分页查看一个语义任务的历史运行记录，了解每次提交的运行标识、执行器任务标识、状态和时间信息。

调用流程

使用 CreateSemanticJob.Data.Name 或 ListSemanticJobs 中的任务名称作为 JobName。
通过 PageNumber 和 PageSize 分页读取记录。
使用记录中的 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": true,
  "Data": {
    "TotalCount": 1,
    "PageNumber": 1,
    "PageSize": 50,
    "JobRuns": [
      {
        "JobRunId": "01H00000000000000000000000",
        "ExecutorJobId": "exec-job-demo",
        "JobName": "semantic-job-demo",
        "UserId": "user-demo",
        "GmtCreate": 1700000000000
      }
    ]
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。