查询运行记录

列出一个导入任务的运行记录，用于确认任务每次执行的状态和处理范围。

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

调用前准备

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

下方示例使用：

• $AI_STUDIO_API_KEY：实际个人访问令牌，通过 X-API-Key Header 传递。

• $WORKSPACE_ID：要查询任务的工作区 ID，通过 X-Workspace-ID Header 传递。

• $TASK_ID：导入任务 ID。

查询参数

参数	类型	是否必填	说明
task_id	string	是	要查询运行记录的导入任务 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"

成功响应

本文中，字段路径中的 [] 表示数组中的每一项。例如，data.runs[].id 表示 data.runs 数组中每一项的 id 字段。

成功时返回 200。

{
  "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_app_id	string	关联工作流应用 ID；未关联时可能省略。
data.runs[].workflow_execution_id	string	关联工作流执行 ID；未关联时可能省略。
data.runs[].status	integer	运行状态代码：1 已创建、2 运行中、3 已完成、4 已失败、5 已取消。
data.runs[].error_message	string	失败信息；无错误时可能省略。
data.runs[].row_count	integer	本次运行处理的行数。
data.runs[].file_count	integer	本次运行处理的文件数。
data.runs[].started_at	string	开始时间；未记录时可能省略。
data.runs[].ended_at	string	结束时间；未记录时可能省略。
data.runs[].created_at	string	运行记录创建时间；未记录时可能省略。
data.runs[].updated_at	string	运行记录最后更新时间；未记录时可能省略。
data.total	integer	运行记录总数。

错误响应

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

常见 HTTP 错误

HTTP 状态码	错误代码	常见原因	建议操作
400	ErrParamInvalid	缺少或使用了无效的 task_id。	传入任务 ID，并确认该任务属于当前工作区。
200	ErrServer	服务未能查询运行记录。	同时检查 HTTP 状态和 code。

后续操作

结合查询任务文件定位失败范围。

最后更新于 2026 年 8 月 22 日