创建组合任务 - CreateMultiTasks
功能介绍
创建组合任务。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。
URI
POST /v2/{project_id}/fdi/instances/{instance_id}/multi-tasks
| 
        参数  | 
      
        是否必选  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|---|
| 
        project_id  | 
      
        是  | 
      
        String  | 
      
        项目ID,获取方式请参见API参考的“附录 > 获取项目ID”章节。  | 
     
| 
        instance_id  | 
      
        是  | 
      
        String  | 
      
        实例ID。  | 
     
请求参数
| 
        参数  | 
      
        是否必选  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|---|
| 
        X-Auth-Token  | 
      
        是  | 
      
        String  | 
      
        用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。  | 
     
| 
        参数  | 
      
        是否必选  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|---|
| 
        task_name  | 
      
        是  | 
      
        String  | 
      
        任务名称,只能以字母、数字为开头,包含字母、数字和 . _ - 3~100个字符。  | 
     
| 
        task_id  | 
      
        否  | 
      
        String  | 
      
        任务ID,可以为空。  | 
     
| 
        task_type  | 
      
        否  | 
      
        String  | 
      
        任务类型,目前组合任务仅支持实时任务。 
  | 
     
| 
        description  | 
      
        否  | 
      
        String  | 
      
        描述信息。  | 
     
| 
        task_tag  | 
      
        否  | 
      
        String  | 
      
        任务标签,只能包含字母、数字、中划线、下划线。  | 
     
| 
        operation_types  | 
      
        是  | 
      
        Array of strings  | 
      
        需要支持的操作类型,支持多选,至少需要选择以下一种: 
  | 
     
| 
        source_app_id  | 
      
        否  | 
      
        String  | 
      
        源端数据源所属集成应用ID。  | 
     
| 
        target_app_id  | 
      
        否  | 
      
        String  | 
      
        目标端数据源所属集成应用ID。  | 
     
响应参数
状态码:200
| 
        参数  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|
| 
        task_id  | 
      
        String  | 
      
        任务ID, 可为空。  | 
     
状态码:400
| 
        参数  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|
| 
        error_code  | 
      
        String  | 
      
        错误码。  | 
     
| 
        error_msg  | 
      
        String  | 
      
        错误描述。  | 
     
状态码:404
| 
        参数  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|
| 
        error_code  | 
      
        String  | 
      
        错误码。  | 
     
| 
        error_msg  | 
      
        String  | 
      
        错误描述。  | 
     
状态码:500
| 
        参数  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|
| 
        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  | 
     
错误码
请参见错误码。