Use this resource to request a list of tasks of a specified type. You can use this resource to retrieve the name and ID for a task.
Do not use this resource to obtain a task ID to run a job. Instead, use the lookup resource. The lookup resource returns the federated task ID which is required to run a task that is not located in the Default folder.
Do not use this resource for a Data Integration mass ingestion task. Instead, use the mass ingestion job resource. For more information, see the Data Integration API.
Try dragging a block from the right to see how easy it is to add more content!
GET Request
To request a list of tasks of a specified type, use the task type code in the following URI.
/api/v2/task?type=<type>
Use the following attribute in the URI:
| Field | Required | Description |
|---|---|---|
| type | Yes | For Data Integration, use one of the following codes: DMASK. Masking task. DRS. Replication task. DSS. Synchronization task. MTT. Mapping task. PCS. PowerCenter task. |
GET Response
If the request is successful, returns the task object for every task of the requested type. Returns the error object if errors occur.
The task object includes the following attributes:
| Field | Type | Description |
|---|---|---|
| id | String | Task ID. |
| orgId | String | Organization ID. |
| name | String | Task name. |
| description | String | Description |
| createTime | String | Time the task was created. |
| updateTime | String | Last time the task was updated. |
| createdBy | String | User who created the task. |
| updatedBy | String | User who last updated the task. |
GET Example
To view a list of all synchronization tasks, use the following request.
/api/v2/task?type=DSS