# 创建组合任务 - CreateMultiTasks #### 功能介绍 创建组合任务。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/ROMA/doc?api=CreateMultiTasks)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-roma/roma_06_0018.html)。 #### 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。 | | task_timezone_offset | 否 | Integer | 任务时区补偿偏移量。 | | task_detail | 是 | [TaskDetail] object | 任务详细信息。 | 表4TaskDetail | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | raw_form_data2 | 否 | [raw_form_data2] object | 任务信息。 | 表5raw_form_data2 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | errorHandler | 否 | Object | 错误处理配置。 | | sourceSelectedDatasource | 否 | [sourceSelectedDatasource] object | 数据源选项。 | | threshold_config | 否 | Object | 阈值配置。 | 表6sourceSelectedDatasource | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | need_inc_migration | 否 | Boolean | 是否需要增量迁移。 | #### 响应参数 **状态码：200** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | task_id | String | 任务ID, 可为空。 | **状态码：400** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码。 | | error_msg | String | 错误描述。 | **状态码：404** 表9响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码。 | | error_msg | String | 错误描述。 | **状态码：500** 表10响应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", "task_detail" : { "raw_form_data2" : { "errorHandler" : { }, "sourceSelectedDatasource" : { "need_inc_migration" : false }, "threshold_config" : { } } } } ``` #### 响应示例 **状态码：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 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-roma/ErrorCode.html)。