更新导入任务¶

更新一个已暂停的导入任务。接口只修改请求中提供的字段；文件筛选配置和来源 URI 使用请求值替换当前值。

POST https://api.moi.matrixorigin.cn/v5/task/update

调用前准备¶

准备有目标工作区访问权限的个人访问令牌、目标工作区 ID 和任务 ID。先查看导入任务详情确认任务已暂停。

请求体¶

将 $AI_STUDIO_API_KEY、$WORKSPACE_ID 和 $TASK_ID 替换为实际值。每次请求可组合下列场景中的字段；同一个对象内只传需要更新的键。

输入示例

修改任务名称和导入周期

curl -X POST "https://api.moi.matrixorigin.cn/v5/task/update" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d "{\n    \\"task_id\\": \\"$TASK_ID\\",\n    \\"name\\": \\"import_orders_v2\\",\n    \\"load_mode_config\\": {\n      \\"load_interval_type\\": 4\n    }\n  }"

修改文件筛选条件

提供 file_filter_config 时会替换当前文件筛选配置。

curl -X POST "https://api.moi.matrixorigin.cn/v5/task/update" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d "{\n    \\"task_id\\": \\"$TASK_ID\\",\n    \\"file_filter_config\\": {\n      \\"filename_globs\\": [\"*.csv\"],\n      \\"file_types\\": [1],\n      \\"path_regex\\": \"^orders/\"\n    }\n  }"

修改来源文件

提供 uris 时会替换当前来源 URI 列表。

curl -X POST "https://api.moi.matrixorigin.cn/v5/task/update" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d "{\n    \\"task_id\\": \\"$TASK_ID\\",\n    \\"uris\\": [\"s3://orders/2026-08.csv\"]\n  }"

参数说明

修改任务名称和导入周期

参数	类型	是否必填	说明
`task_id`	string	是	要更新的导入任务 ID。
`name`	string	否	新任务名称；空字符串不会更新名称。
`load_mode_config`	object	否	新的文件导入周期。
`load_mode_config.load_interval_type`	integer	否	导入周期类型；示例中的 `4` 表示一次性导入。

修改文件筛选条件

参数	类型	是否必填	说明
`task_id`	string	是	要更新的导入任务 ID。
`file_filter_config`	object	否	文件筛选配置。
`file_filter_config.filename_globs`	string（字符串数组）	否	文件名 glob 模式。
`file_filter_config.file_types`	integer（整数数组）	否	文件类型筛选代码。
`file_filter_config.path_regex`	string	否	文件路径筛选正则表达式。

修改来源文件

参数	类型	是否必填	说明
`task_id`	string	是	要更新的导入任务 ID。
`uris`	string（字符串数组）	否	来源文件 URI 列表。

成功响应¶

响应示例

{
  "code": "OK",
  "msg": "OK",
  "data": null
}

字段说明

字段	类型	说明
`code`	string	成功时为 `OK`。
`msg`	string	成功时为 `OK`。
`data`	null	不返回更新后的任务。

错误响应¶

响应示例

{
  "code": "ErrServer",
  "msg": "task must be paused before update",
  "data": null
}

字段说明

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

后续操作¶

使用同一任务 ID 查看导入任务详情确认更新结果。

最后更新于 2026 年 9 月 9 日