查看导出任务详情¶

查看导出任务及其目标配置与文件统计。

POST https://api.moi.matrixorigin.cn/v5/export/task/info

调用前准备¶

从查看导出任务列表取得任务 ID，并准备有目标工作区访问权限的个人访问令牌和目标工作区 ID。

请求体¶

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

输入示例

curl -X POST "https://api.moi.matrixorigin.cn/v5/export/task/info" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H 'Content-Type: application/json' \
  -d @- <<EOF
{
    "id": "$TASK_ID"
  }
EOF

参数说明

参数	类型	是否必填	说明
`id`	string	是	要读取的导出任务 ID。

成功响应¶

data.config 仅包含创建该任务时选择的目标配置；配置字段与创建导出任务中的对应目标场景一致。

响应示例

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "id": "export-task-123",
    "name": "export-to-s3",
    "creator": "data-engineer",
    "connector_name": "target-s3",
    "type": 5,
    "status": 2,
    "config": {
      "s3_config": {
        "path": "exports/",
        "need_compress": false,
        "compress_method": ""
      }
    },
    "create_time": "2026-08-28T10:00:00Z",
    "end_time": "2026-08-28T10:02:00Z",
    "file_stats": {
      "total": 4,
      "pending": 0,
      "running": 0,
      "failed": 1,
      "completed": 3
    },
    "fileSuccess": 3,
    "fileFail": 1
  }
}

字段说明

字段	类型	说明
`code`	string	成功时为 `OK`。
`msg`	string	成功时为 `OK`。
`data`	object	导出任务详情。
`data.id`	string	任务 ID。
`data.name`	string	任务名称。
`data.creator`	string	创建者标识。
`data.connector_name`	string	目标连接器名称。
`data.type`	integer	导出目标类型。
`data.status`	integer	任务状态。
`data.config.s3_config`	object	对象存储目标配置。
`data.config.s3_config.path`	string	目标路径。
`data.config.s3_config.need_compress`	boolean	是否压缩导出内容。
`data.config.s3_config.compress_method`	string	压缩方式。
`data.create_time`	string 或 null	创建时间。
`data.end_time`	string 或 null	结束时间。
`data.file_stats`	object	文件数量汇总。
`data.file_stats.total`	integer	文件总数。
`data.file_stats.pending`	integer	待处理文件数。与 `running` 均为 `0` 时，本次处理已结束。
`data.file_stats.running`	integer	正在导出的文件数。
`data.file_stats.failed`	integer	失败文件数。为 `0` 且处理已结束时，表示所有文件成功。
`data.file_stats.completed`	integer	已完成文件数。
`data.fileSuccess`	integer	已成功导出的文件数。
`data.fileFail`	integer	导出失败的文件数。

错误响应¶

响应示例

{
  "code": "ErrServer",
  "msg": "未找到导出任务",
  "data": null
}

字段说明

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

后续操作¶

使用相同任务 ID 查看导出任务文件列表；需要简要计数时查看导出任务状态。

最后更新于 2026 年 9 月 6 日