查看导入任务运行记录列表¶

列出一个导入任务的运行记录，用于确认每次执行的状态和处理范围。该接口只接受任务 ID，不支持状态、排序或分页参数。

GET https://moi.matrixorigin.cn/newmoi/task/runs?task_id=$TASK_ID

调用前准备¶

准备有目标工作区访问权限的个人访问令牌、目标工作区 ID 和任务 ID。

查询参数¶

将 $AI_STUDIO_API_KEY、$WORKSPACE_ID 和 $TASK_ID 替换为实际值。

调用示例

curl "https://moi.matrixorigin.cn/newmoi/task/runs?task_id=$TASK_ID" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

参数说明

参数	类型	是否必填	说明
`task_id`	string	是	要查看运行记录的导入任务 ID。

成功响应¶

响应示例

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "runs": [
      {
        "id": "run_01",
        "import_task_id": "task_01",
        "workflow_execution_id": "exec_01",
        "status": 2,
        "row_count": 100,
        "file_count": 1,
        "started_at": "2026-08-18T10:00:00Z",
        "ended_at": "2026-08-18T10:01:00Z"
      }
    ],
    "total": 1
  }
}

字段说明

字段	类型	说明
`code`	string	成功时为 `OK`。
`msg`	string	成功时为 `OK`。
`data.runs`	object（对象数组）	运行记录。
`data.runs.id`	string	运行 ID。
`data.runs.import_task_id`	string	所属导入任务 ID。
`data.runs.workflow_execution_id`	string	关联工作流执行 ID；未关联时可能省略。
`data.runs.status`	integer	运行状态：1 已创建、2 运行中、3 已完成、4 已失败、5 已取消。
`data.runs.row_count`	integer	本次运行处理的行数。
`data.runs.file_count`	integer	本次运行处理的文件数。
`data.runs.started_at`	string	开始时间；未记录时可能省略。
`data.runs.ended_at`	string	结束时间；未记录时可能省略。
`data.total`	integer	运行记录总数。

错误响应¶

响应示例

{
  "code": "ErrParamInvalid",
  "msg": "task_id is required",
  "data": null
}

字段说明

字段	类型	说明
`code`	string	错误代码。
`msg`	string	可读错误信息。
`data`	null	错误响应中为 `null`。

后续操作¶

结合查看导入任务文件列表定位失败范围。

最后更新于 2026 年 9 月 3 日