Reconciliation Tools Available through the REST API
- Andrea Harvey
- Lindsey Byers (Deactivated)
On This Page
Overview
This page outlines REST API calls you can use to help reconcile a job.
Verify all Requested Features for a Job
When creating your job using JSON, a wide variety of features may have been used. To verify all were implemented as intended. We recommend verifying this by performing a Job Details call:
Create your JSON with desired features.
Submit your job.
Before you start your job, run the following:
GET {{url}}v1/jobs/{{job}}?fields=allExpected Response
The response will include each feature you requested. If your requested feature is not listed, it is likely due to incorrect JSON (not an invalid JSON). While your JSON may appear to be valid, your requested feature likely falls outside of the transfer block. Review and update your request so the feature falls within the transfer block.
Review Job Warnings
After reviewing your Job Audit History, you may observe warnings that occurred after your job completes successfully. Here is how you can investigate these warnings.
GET {{url}}v1/jobs/{{job}}/history/?include=allExample Response
{
"status": 200,
"meta": {
"links": {
"self": {
"href": "http://000.000.0.250:9090/v1/jobs/{{job_id}}/history/?offset=0&limit=100&fields=all"
},
"download": {
"href": "http://000.000.1.250:9090/v1/jobs/{{job_id}}/history/.csv"
}
},
"offset": 0,
"limit": 100,
"fields": [
"all"
],
"total_count": 1
},
"type": "job_executions",
"job_executions": [
{
"job_id": "{{job_id}}",
"progress": 1,
"phase": "complete",
"id": 108,
"start_time": 1522232339,
"end_time": 1522232358,
"duration": {
"value": 18.91,
"unit": "s"
},
"status": "completed",
"node_address": "000.000.1.250",
"stats": {
"destination": {
"folders": 5,
"import": {
"metadata": 9
},
"new": {
"bytes": 116070,
"files": 10,
"versions": 10
},
"pending": {
"batches": 0,
"files": 0,
"versions": 0
},
"rate_limits": 0
},
"source": {
"pending": {
"batches": 0,
"files": 0,
"versions": 0
},
"rate_limits": 0
},
"warnings": 56
}
}
]
}
Job Audit History with Warnings Only
Run the call below.
Copy the download link from the response body. Paste this link into your Chrome browser. You may need to log into the application again. Your browser will download the audit log with just the warnings as a .csv file.
Example Response
Review Job Errors
Run the call below.
Copy the download link from the response body. Paste this link into your Chrome browser. You may need to log into the application again. Your browser will download the audit log with just the warnings as a .csv file.
Example Response