All Products
Search
Document Center

DataWorks:StartDIJob

Last Updated:Oct 17, 2024

Starts a synchronization task of a new version. Only the following type of task is supported: real-time data synchronization from a MySQL database to Hologres.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
DIJobIdlongYes

The task ID.

11743
RealtimeStartSettingsobjectNo

The settings for the start.

StartTimelongNo

The timestamp of the start offset. Unit: seconds. If you do not configure this parameter, the offset is not reset by default.

1671516776
FailoverSettingsobjectNo

The failover settings.

IntervallongNo

The failover interval. Unit: minutes.

10
UpperLimitlongNo

The maximum number of failovers.

30
ForceToRerunbooleanNo

Specifies whether to forcefully rerun all synchronization steps. If you do not configure this parameter, the system does not forcefully rerun the task.

true

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

RequestIdstring

The request ID.

999431B2-6013-577F-B684-36F7433C753B

Examples

Sample success responses

JSONformat

{
  "RequestId": "999431B2-6013-577F-B684-36F7433C753B"
}

Error codes

HTTP status codeError codeError messageDescription
403Forbidden.AccessAccess is forbidden. Please first activate DataWorks Enterprise Edition or Flagship Edition.No permission, please authorize
429Throttling.ApiThe request for this resource has exceeded your available limit.-
429Throttling.SystemThe DataWorks system is busy. Try again later.-
429Throttling.UserYour request is too frequent. Try again later.-
500InternalError.SystemAn internal system error occurred. Try again later.-
500InternalError.UserId.MissingAn internal system error occurred. Try again later.-

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
No change history