查看导入任务详情¶

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

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

调用前准备¶

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

查询参数¶

将 $AI_STUDIO_API_KEY、$WORKSPACE_ID 和 $TASK_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"

参数说明

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

成功响应¶

响应示例

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "task": {
      "id": "task_01",
      "name": "import_orders",
      "config_type": 1,
      "source_connector_id": "conn_01",
      "connector_name": "orders_s3",
      "volume_id": "vol_01",
      "status": 1,
      "total_rows": 100,
      "imported_rows": 0
    }
  }
}

字段说明

字段	类型	说明
`code`	string	成功时为 `OK`。
`msg`	string	成功时为 `OK`。
`data.task`	object	任务定义和当前处理状态。字段含义见导入任务返回字段。
`data.task.id`	string	任务 ID。
`data.task.name`	string	任务名称。
`data.task.config_type`	integer	任务配置类型。
`data.task.source_connector_id`	string	来源连接器 ID。
`data.task.connector_name`	string	来源连接器名称。
`data.task.volume_id`	string	目标数据卷 ID。
`data.task.status`	integer	当前任务状态。
`data.task.total_rows`	integer	累计待处理行数。
`data.task.imported_rows`	integer	累计已导入行数。

错误响应¶

响应示例

{
  "code": "ErrServer",
  "msg": "task not found",
  "data": null
}

字段说明

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

后续操作¶

使用任务 ID 查看导入任务文件列表查看文件级结果，或查看导入任务运行记录列表查看历次运行。需要重试时，将失败文件 ID 传给重试导入失败文件。

最后更新于 2026 年 9 月 3 日