文档首页/应用与数据集成平台 ROMA Connect/API参考/数据集成API/任务管理/创建组合任务 - CreateMultiTasks
更新时间：2025-10-22 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建组合任务 - CreateMultiTasks

功能介绍

创建组合任务。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

POST /v2/{project_id}/fdi/instances/{instance_id}/multi-tasks

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID，获取方式请参见API参考的“附录 > 获取项目ID”章节。

instance_id

是

String

实例ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

表3 请求Body参数

参数

是否必选

参数类型

描述

task_name

是

String

任务名称，只能以字母、数字为开头，包含字母、数字和 . _ - 3~100个字符。

task_id

否

String

任务ID，可以为空。

task_type

否

String

任务类型，目前组合任务仅支持实时任务。

  • REALTIME (实时)

  • TIMING (定时)

description

否

String

描述信息。

task_tag

否

String

任务标签，只能包含字母、数字、中划线、下划线。

operation_types

是

Array of strings

需要支持的操作类型，支持多选，至少需要选择以下一种：

  • INSERT

  • UPDATE

  • DELETE

source_app_id

否

String

源端数据源所属集成应用ID。

target_app_id

否

String

目标端数据源所属集成应用ID。

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

task_id

String

任务ID, 可为空。

状态码：400

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

状态码：404

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

状态码：500

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

创建一个数据集成组合任务，任务类型为实时任务，包含插入、更新和删除操作

{
  "task_name" : "cdctest1",
  "task_id" : "a9fe65f41****6a5d646477c52",
  "task_type" : "REALTIME",
  "description" : "create",
  "task_tag" : "combination",
  "operation_types" : [ "INSERT", "UPDATE", "DELETE" ],
  "source_app_id" : "d5afd9af-a8fe-47f6-a98c-edbcba11a0da",
  "target_app_id" : "d5afd9af-a8fe-47f6-a98c-edbcba11a0da"
}

响应示例

状态码：400

Bad Request

{
  "error_code" : "FDI.3150",
  "error_msg" : "The task list is empty."
}

状态码：404

Not Found

{
  "error_code" : "FDI.3083",
  "error_msg" : "One or more scheduled tasks are not configured with scheduled plans."
}

状态码

状态码

描述

200

OK

400

Bad Request

404

Not Found

500

Internal Server Error

错误码

请参见错误码。

父主题：任务管理