Use a PUT request to update a mass ingestion task.
PUT request
To update a mass ingestion task, use the following URI:
mftsaas/api/v1/mitasks/<taskID>
Include the following fields in the PUT request:
Field | Type | Required | Description |
---|---|---|---|
id | Stirng | -- | ID number of the task. |
name | Stirng | Yes | Name of the task. |
location | Stirng | Location of the project. | |
projectId | Stirng | ID number associated with the project. | |
projectName | Stirng | Name of the project. | |
description | Stirng | Description of the task. | |
sourceType | Stirng | Yes | Determines the type where files are transferred. Enter one of the following options: |
sourceConnection | Stirng | -- | Directory from where files are transferred. |
includeSubfolder | Stirng | -- | Values are true or false. Set the value to true to transfer files from all sub-folders under the defined source directory |
checkDuplicate | Stirng | -- | Values are true or false. Set the value to true to check duplicate files and deny file transfer. If the value is set to false all files are transferred. |
filePatternType | Stirng | Yes | File name pattern used to select the files to transfer. Enter one of the following options: |
filePattern | Stirng | Yes | Enter pattern types, depending on the file pattern that you have selected. |
postPickupAction | Stirng | Determines what to do with source files after the files transfer. The following options are available: | |
targetConnection | Stirng | Yes | Directory details to which files are transferred. |
PUT request example
Use this sample as a reference to update a mass ingestion task.
PUT <serverUrl>/public/core/v1/mitasks
Content-Type: application/json
Accept:application/json
Content-Type:application/json
IDS-SESSION-ID:{{IDS-SESSION-ID}}
{
"id": "cEMWKpibm44bNf5aMjbJ4U",
"name": "Green Green v2",
"location": {
"projectId": "9JDNOBX9M31e2AD1dIUv6M",
"projectName": "Default"
},
"description": "Green Green v2 Description",
"sourceType": "CONNECTION",
"sourceConnection": {
"id": "",
"name": "",
"type": "local"
},
"sourceParameters": {
"filePattern": "*.txt",
"filePatternType": "WILDCARD",
"includeSubfolder": "false",
"sourceDirectory": "C:\\Monitor",
"checkDuplicate": "false",
"postPickupAction": "KEEP"
},
"targetConnection": {
"id": "0100000B000000000002",
"name": "ADLS",
"type": "Azure Data Lake"
},
"targetParameters": {
"adlsTargetLocation": "/satyen/green"
},
"agentGroupId": "01000025000000000002
}
PUT response example
If the request is successful, you might receive a response similar to the following example:
{
"id": "cEMWKpibm44bNf5aMjbJ4U",
"name": "Green Green v2",
"location": {
"projectId": "9JDNOBX9M31e2AD1dIUv6M",
"projectName": "Default"
},
"description": "",
"sourceType": "CONNECTION",
"sourceConnection": {
"id": "",
"name": "",
"type": "local"
},
"sourceParameters": {
"filePattern": "*.txt",
"filePatternType": "WILDCARD",
"includeSubfolder": "false",
"sourceDirectory": "C:\\Monitor",
"checkDuplicate": "false",
"postPickupAction": "KEEP
},
"targetConnection": {
"id": "0100000B000000000002",
"name": "ADLS",
"type": "Azure Data Lake"
},
"targetParameters": {
"adlsTargetLocation": "/satyen/green"
},
"agentGroupId": "01000025000000000002",
"createdTime": "2018-08-27T07:03:32Z",
"updatedTime": "2018-08-29T12:14:58Z"
}
Note
The created and updated time in the response is displayed in the UTC time.