Starts a Data Integration task of a new version. Only the following type of task is supported: real-time data synchronization from a MySQL database to Hologres.
Debugging
Request parameters
Parameter |
Type |
Required |
Example |
Description |
Action | String | Yes | StartDIJob | The operation that you want to perform. Set the value to StartDIJob. |
DIJobId | Long | Yes | 11743 | The task ID. |
RealtimeStartSettings | Object | No | The settings for the start. |
|
StartTime | Long | No | 1671516776 | The timestamp of the start offset. Unit: seconds. If you do not configure this parameter, the offset is not reset by default. |
FailoverSettings | Object | No | The failover settings. |
|
Interval | Long | No | 10 | The failover interval. Unit: minutes. |
UpperLimit | Long | No | 30 | The maximum number of failovers. |
ForceToRerun | Boolean | No | true | Specifies whether to forcefully rerun all synchronization steps. If you do not configure this parameter, the system does not forcefully rerun the task. |
Response parameters
Parameter |
Type |
Example |
Description |
RequestId | String | 999431B2-6013-577F-B684-36F7433C753B | The request ID. |
Examples
Sample requests
http(s)://[Endpoint]/?Action=StartDIJob
&DIJobId=11743
&RealtimeStartSettings={"StartTime":1671516776,"FailoverSettings":{"Interval":10,"UpperLimit":30}}
&ForceToRerun=true
&Common request parameters
Sample success responses
XML
format
HTTP/1.1 200 OK
Content-Type:application/xml
<StartDIJobResponse>
<RequestId>999431B2-6013-577F-B684-36F7433C753B</RequestId>
</StartDIJobResponse>
JSON
format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "999431B2-6013-577F-B684-36F7433C753B"
}
Error codes
HTTP status code |
Error code |
Error message |
Description |
429 | Throttling.Api | The request for this resource has exceeded your available limit. | The number of requests for the resource has exceeded the upper limit. |
429 | Throttling.System | The DataWorks system is busy. Try again later. | The DataWorks system is busy. Try again later. |
429 | Throttling.User | Your request is too frequent. Try again later. | Excessive requests have been submitted within a short period of time. Try again later. |
500 | InternalError.System | An internal system error occurred. Try again later. | An internal error has occurred. Try again later. |
500 | InternalError.UserId.Missing | An internal system error occurred. Try again later. | An internal error has occurred. Try again later. |
For a list of error codes, see Service error codes.