发布实时同步任务和同步解决方案任务。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DeployDISyncTask

系统规定参数。取值:DeployDISyncTask

ProjectId Long 10000

DataWorks工作空间的ID。您可以登录DataWorks控制台,进入工作空间管理页面获取ID。

该参数用来确定本次API调用操作使用的DataWorks工作空间。

TaskType String DI_REALTIME

目标数据源所关联的数据集成同步任务的任务类型。取值如下:

  • DI_REALTIME:表示数据集成实时同步任务。
  • DI_SOLUTION:表示数据集成同步解决方案。
RegionId String cn-zhangjiakou

地域信息,通常为服务所在的地域。例如,华东2(上海)为cn-shanghai,华北3(张家口)为cn-zhangjiakou。您无需填写RegionId,会根据调用的Endpoint自动解析。

FileId Long 100
  • 当TaskType为DI_REALTIME时,则FileId为实时同步任务的文件ID。
  • 当TaskType为DI_SOLUTION时,则FileId为同步解决方案的任务ID。

您可以调用ListFiles接口获取任务ID。

返回数据

名称 类型 示例值 描述
Success Boolean true

请求是否成功。取值如下:

  • true:成功。
  • false:失败。
RequestId String 0bc1411515937635973****

请求ID。用于定位日志,排查问题。

Data Object

发布同步任务的结果。

Status String success

发布数据集成同步任务的结果状态。取值如下:

  • success:表示发布数据集成同步任务成功。
  • fail:表示发布数据集成同步任务失败。
Message String submit and deploy fail.

发布数据集成同步任务失败后的原因描述。

如果发布数据集成同步任务成功,则该参数的返回值为空。

示例

请求示例

http(s)://[Endpoint]/?Action=DeployDISyncTask
&ProjectId=10000
&TaskType=DI_REALTIME
&FileId=100
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DeployDISyncTaskResponse>
    <Success>true</Success>
    <RequestId>0bc1411515937635973****</RequestId>
    <Data>
        <Status>success</Status>
        <Message>submit and deploy fail.</Message>
    </Data>
</DeployDISyncTaskResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Success" : true,
  "RequestId" : "0bc1411515937635973****",
  "Data" : {
    "Status" : "success",
    "Message" : "submit and deploy fail."
  }
}

错误码

HttpCode 错误码 错误信息 描述
400 Param.Invalid The parameter is invalid. 参数错误
500 InternalError.System An internal error occurred. 内部报错
403 Forbidden.Access Access is forbidden. 没有权限

访问错误中心查看更多错误码。