查询任务详情¶

读取一个导入任务的定义和当前状态。创建、暂停、恢复或重试后，都使用此接口确认任务是否进入预期状态。

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

调用前准备¶

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

下方示例使用：

$AI_STUDIO_API_KEY：实际个人访问令牌，通过 X-API-Key Header 传递。
$WORKSPACE_ID：要查询的工作区 ID，通过 X-Workspace-ID Header 传递。
$TASK_ID：创建任务响应中的 data.task_id。

查询参数¶

参数	类型	是否必填	说明
`task_id`	string	是	要查询的导入任务 ID。

请求示例¶

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

成功响应¶

成功时返回 200。

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "task": {
      "id": "task_01",
      "name": "import_orders",
      "config_type": 1,
      "source_connector_id": "conn_01",
      "connector_name": "orders_mysql",
      "volume_id": "vol_01",
      "status": 2,
      "total_rows": 100,
      "imported_rows": 100,
      "success_file_count": 1,
      "failed_file_count": 0,
      "latest_rows": {
        "read_rows": 100,
        "succeeded_rows": 100,
        "failed_rows": 0,
        "complete": true
      },
      "error_code": "",
      "error_summary": ""
    }
  }
}

响应字段如下。

字段	类型	说明
`code`	string	成功时为 `OK`。
`msg`	string	成功时为 `OK`。
`data.task`	object	任务定义和当前处理状态。该对象的每个字段见导入任务对象字段。

错误响应¶

{
  "code": "ErrServer",
  "msg": "server error",
  "data": null
}

常见 HTTP 错误¶

HTTP 状态码	错误代码	常见原因	建议操作
`200`	`ErrServer`	任务不存在、不可读取，或服务未能查询任务。	同时检查 HTTP 状态和 `code`，并确认 `task_id` 与授权。

后续操作¶

用任务 ID 查询任务文件查看文件级结果，或查询运行记录查看历次运行。失败文件较多时，将失败文件的 id 交给重试失败文件。

最后更新于 2026 年 8 月 22 日