DTSS Tasks
Learn about the tasks you can do with DTSS APIs.
DTSS tasks can be created, stopped and monitored by submitting appropriate requests to the DTSS API, which is invoked using the REST protocol with JSON files.
The main components of a task are the following:
- Task Status - This indicates what stage of the process the task is currently in.
- DTSS Endpoint URLs - The endpoints for each task.
- Create task - This is used to start a task.
- Stop task - This is used to stop a task.
- Monitor task - There are two ways to monitor tasks. You can get status for a specific task or all tasks.
As a task moves through the various stages of its lifecycle, it'll have different statuses.
| Task Status | Description |
|---|---|
| ASSIGNED | The task has been assigned to a cluster for processing. |
| NOT_STARTED | Initial status after task creation. |
| WAITING | Sub-tasks are in progress. The parent task is waiting for those to be completed. |
| STARTED | The task is in progress. |
| FINISHED | The task is completed. |
| ERROR | The task stopped due to errors. |
| STOPPED | The task was stopped by an API request. It cannot be restarted. |
The DTSS URL is constructed in the following manner:
Endpoint construction format: https://{env}.reltio.com/dtss
Where: The {env} is the environment where the CT and DT are hosted. For example, dev, test, or 361. Reltio.com/dtss specifies the DTSS API. Note that additional parameters are sometimes required in the header of the HTTP request.