View mass ingestion tasks

Use the GET request to view mass ingestion tasks.

GET request

To view the details of a particular mass ingestion task, include the mass ingestion in the following URI:

mftsaas/api/v1/mitasks/{{TASK-ID}}

To view the details for all mass ingestion tasks in the organization, omit the mass ingestion ID.

mftsaas/api/v1/mitasks

For example:

GET https://na1.dm-us.informaticacloud.com/mftsaas/api/v1/mitasks

GET response

Returns the task object if successful or an error object if errors occur.
The task object includes the following information about each of the mass ingestion tasks in the organization:

Field

Type

Description

taskId

String

ID number associated with the task.

taskName

String

Name of the task.

description

String

Description of the task.

location

String

Project and folder path where the task exists.

createTime

Date/time

Time when the task was created.

updateTime

Date/time

Time when the task was last updated.

The create and update time in the response are in UTC time.

Get response example for one mass ingestion task

The following sample response shows details of a mass ingestion task.

IDS-SESSION-ID:{{IDS-SESSION-ID}}
Accept:application/json
{
    "id": "j9OLB12nqYObykdFSUMpO2",
    "name": "FTPSrcTarget",
    "location": {
        "projectId": "dNC6zbp2lI8ghrKPo6hpwn",
        "projectName": "Hardening"
    },
    "description": "",
    "sourceType": "CONNECTION",
    "sourceConnection": {
        "id": "0100000B00000000028M",
        "name": "CCI_FTPS",
        "type": "Advanced FTPS V2"
    },
    "targetConnection": {
        "id": "0100000B0000000001JR",
        "name": "CCI_FTP_Lin",
        "type": "Advanced FTP V2"
    },
    "sourceParameters": {
        "filePattern": "*.txt",
        "sourceTransferMode": "AUTO",
        "filePatternType": "WILDCARD",
        "includeSubfolder": "false",
        "sourceDirectory": "/root/suraj/qa/test/automation/RSFiles",
        "checkDuplicate": "false",
        "postPickupAction": "KEEP"
    },
    "targetParameters": {
        "fileExistsAction": "APPEND_TIMESTAMP",
        "targetDirectory": "/",
        "targetTransferMode": "AUTO"
    },
    "agentGroupId": "01000025000000000003",
    "createdTime": "2019-02-04T10:34:08Z",
    "updatedTime": "2019-02-04T11:04:02Z"
}

GET response example to view all mass ingestion tasks

The following sample response shows that there are two mass ingestion tasks in the organization:

{
    "mitasks": [
        {
            "id": "1ONE5Vewzztl0tuKR0EDum",
            "name": "A01_UMAR_MITASK2318",
            "description": "",
            "sourceType": "CONNECTION",
            "sourceConnection": {
                "id": "",
                "name": "",
                "type": "local"
            },
            "targetConnection": {
                "id": "0100000B000000000002",
                "name": "ftps",
                "type": "Advanced FTPS"
            },
            "agentGroupId": "01000025000000000002",
            "updatedTime": "2019-01-30T11:17:49Z"
        },
        {
            "id": "9D1tGkAxopJeFmUWoG4s48",
            "name": "A01_UMAR_MITASK3354",
            "description": "",
            "sourceType": "CONNECTION",
            "sourceConnection": {
                "id": "0100000B00000000000M",
                "name": "AzureBlob",
                "type": "Azure Blob"
            },
            "targetConnection": {
                "id": "0100000B00000000000L",
                "name": "SFTP_Conn",
                "type": "Advanced SFTP"
            },
            "agentGroupId": "01000025000000000002",
            "updatedTime": "2019-01-30T06:42:19Z"
        },
        {
            "id": "4hcTFqKVOQrl1z4d6pGUMP",
            "name": "A01_UMAR_MITASK5124",
            "description": "",
            "sourceType": "CONNECTION",
            "sourceConnection": {
                "id": "0100000B0000000004IO",
                "name": "S3",
                "type": "AmazonS3"
            },
            "targetConnection": {
                "id": "",
                "name": "",
                "type": "local"
            },
            "agentGroupId": "01000025000000000002",
            "updatedTime": "2019-01-30T06:35:01Z"
        }]
        }