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

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

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

调用前准备

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

查询参数

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

调用示例

curl "https://api.moi.matrixorigin.cn/v5/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,
        "current_phase": "loading",
        "runtime_job_id": "job_01",
        "runtime_job_state": "running",
        "manifest_rows": 100,
        "staging_rows": 100,
        "compressed_bytes": 2048,
        "manifest_uri": "s3://bucket/manifests/run_01.json",
        "manifest_digest": "sha256:...",
        "checkpoint_json": "{\"offset\":100}",
        "started_at": "2026-08-18T10:00:00Z",
        "ended_at": "2026-08-18T10:01:00Z"
      }
    ],
    "total": 1
  }
}

字段说明

字段	类型	说明
code	string	成功时为 OK。
msg	string	成功时为 OK。
data.runs	array	运行记录。
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.current_phase	string	当前处理阶段；未记录时可能省略。
data.runs.runtime_job_id	string	关联的运行时作业 ID；未创建运行时作业时可能省略。
data.runs.runtime_job_state	string	关联运行时作业的状态；未创建运行时作业时可能省略。
data.runs.manifest_rows	integer	清单中的行数；未生成清单时可能省略。
data.runs.staging_rows	integer	暂存阶段处理的行数；未进入暂存阶段时可能省略。
data.runs.compressed_bytes	integer	本次运行处理的压缩数据字节数；未记录时可能省略。
data.runs.manifest_uri	string	清单存储位置；未生成清单时可能省略。
data.runs.manifest_digest	string	清单内容摘要；未生成清单时可能省略。
data.runs.checkpoint_json	string	运行检查点的 JSON 文本；未生成检查点时可能省略。
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 月 28 日