The server URL includes the name and region of the POD that your organization uses and the domain, informaticacloud.com. If you don't know the name and region of your organization's POD, you can find it by logging in through the user interface. The POD information is located in the browser's address bar.
In the following example, https://usw3.dm-us.informaticacloud.com is the server URL:
Use the convert resource to test whether a synchronization task can be converted to a data transfer task. If the synchronization task isn't compatible with data transfer task features, the response includes the reasons for the incompatibility.
GET request
To find out if a synchronization task can be converted to a data transfer task, use the following URI:
/dtt/dss/convert/test/<assetId
To find the asset ID, you can send a lookup request. For information about the lookup resource, see Lookup.
GET response
The response includes the following information:
Field
Type
Description
assetId
String
ID of the synchronization task to be converted.
assetName
String
Name of the synchronization task to be converted.
dttparity
Boolean
Whether the synchronization task is compatible with data transfer task features. A Yes value means the synchronization task is compatible with data transfer task features so the task can be converted.
errors
String
If the value for dttparity is No, includes reasons why the synchronization task can't be converted to a data transfer task.
GET example
The following request checks a synchronization task to see if it's compatible with data transfer task features:
GET <server URL>/dtt/dss/convert/test/0001R291234567891234 Content-type: application/json Accept: application/json INFA-SESSION-ID: 2l0oeVx22Rujiej7y1234T
The following response shows that the synchronization task can be converted to a data transfer task:
The following text is an example of a response when the synchronization task can't be converted to a data transfer task:
{ "assetId": "0001R291234567896789", "assetName": "Sync Task 2", "errors": [ "Multiple source objects are not supported" ], "dttparity": NO }
Converting an asset to a data transfer task
Use the convert resource to convert a synchronization task to a data transfer task. The synchronization task still exists after the conversion, but you can delete it.
POST request
To convert a synchronization task, include the asset ID of the synchronization task in the following URI:
/dtt/dss/convert/<assetId>
Include the following fields in the request:
Field
Type
Required
Description
projectId
String
Yes
Project or folder where you want the data transfer task to reside.
skipSchedulerJob
Boolean
--
Whether to exclude the schedule settings from the synchronization task in the data transfer task. Use one of the following values:
- true: Don't include the schedule settings.
- false: Include the schedule settings.
Default is false.
POST response
The following table describes the fields in the POST response:
Field
Type
Description
originalAssetId
String
ID of the synchronization task that was converted.
originalAssetName
String
Name of the synchronization task that was converted.
status
String
Status of the conversion, such as SUCCESS or FAILED.
newAssetId
String
Asset ID of the new data transfer task.
newAssetName
String
Name of the data transfer task, which is the same as the synchronization task used in the conversion.
newAssetType
String
Value will always be DTT.
errors
String
If the status is FAILED, reason for the failure.
POST example
The following request converts a synchronization task to a data transfer task:
POST <server URL>/dtt/dss/convert/0001R291234567891234 Content-Type: application/json Accept:application/json IDS-SESSION-ID:2l0oeVx22Rujiej7y1234T