All Products
Search
Document Center

DataWorks:StartDIJob

Last Updated:Jan 12, 2026

Starts a new-version synchronization task.

Operation description

This API operation is available for all DataWorks editions.

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
IdlongNo

The ID of the synchronization task.

10000
ForceToRerunbooleanNo

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

  • If the system does not perform the forcible rerun operation, only the steps that are not run start to run.
  • If the system performs the forcible rerun operation, all steps start to rerun.
false
RealtimeStartSettingsobjectNo

The settings for starting real-time synchronization.

{
  "StartTime":1663765058
}
StartTimelongNo

The start time.

1671516776
FailoverSettingsdeprecatedobjectNo

This parameter is deprecated. Use advanced parameters for failover settings when you create a task.

IntervaldeprecatedlongNo

This parameter is deprecated. Use advanced parameters for failover settings when you create a task.

10
UpperLimitdeprecatedlongNo

This parameter is deprecated. Use advanced parameters for failover settings when you create a task.

30
DIJobIddeprecatedstringNo

This parameter is deprecated. Use the Id parameter instead.

10000

Response parameters

ParameterTypeDescriptionExample
object

Schema of Response

Successboolean

Indicates whether the request was successful. Valid values:

  • true
  • false
true
RequestIdstring

The request ID.

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

Examples

Sample success responses

JSONformat

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

Error codes

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

Change history

Change timeSummary of changesOperation
2025-01-06The request parameters of the API has changedView Change Details
2024-10-15The internal configuration of the API is changed, but the call is not affectedView Change Details