Table of Contents

Search

  1. Preface
  2. Informatica Intelligent Cloud Services REST API
  3. Platform REST API version 2 resources
  4. Platform REST API version 3 resources
  5. Data Integration REST API
  6. Mass Ingestion Files REST API
  7. RunAJob utility
  8. REST API codes
  9. REST API resource quick references

REST API Reference

REST API Reference

task

task

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
file ingestion
task. Instead, use the
file ingestion
job resource. For more information see, tasks.

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


Updated May 03, 2021