JOC API

Version 1.12.0

Download RAML
JOC API
/tasks/history
POST

Task history from reporting (permanent)


Parameters in the POST body schema

Name Type Description Example Default
jobschedulerId optional, string JobScheduler Master ID scheduler
jobs optional, array Filtered response by a collection of jobs specified by its job path.
Other parameters such as folders, excludeJobs and regex are ignored if this parameter is defined.
[{
"job":"/sos/reporting/Inventory"
}]
excludeJobs optional, array Response contains all jobs except the jobs which are specified in this collection.
This parameter will be ignored if jobs parameter is set.
[{
"job":"/sos/reporting/Inventory"
}]
dateFrom optional, string The value has multiple formats
  • a format for a date in ISO 8601 format where the time offset and milliseconds are optional, e.g.
    • YYYY-MM-DDThh:mm:ss[.s][Z (Z means +00)]
    • YYYY-MM-DDThh:mm:ss[.s][+01:00]
    • YYYY-MM-DDThh:mm:ss[.s][+0100]
    • YYYY-MM-DDThh:mm:ss[.s][+01]
  • a format for a time period in relative to the current time, e.g. 6h, 12h, 1d, 1w can specify in addition with a time offset 0 or digits followed by a letter are expected where the letter has to be:
    • s (seconds)
    • m (minutes)
    • h (hours)
    • d (days)
    • w (weeks)
    • M (months)
    • y (years)
  • a time offset is optional (e.g. 2d+02:00)
    • it can be also specify with the parameter timeZone
    • if timeZone undefined then UTC is used
  • the value 0 means the current time
  • Returns only collection items younger than this date.
1d
dateTo optional, string The value has multiple formats like the dateFrom parameter
  • Return only collection items older than this date.
0
timeZone optional, string
  • If this parameter is set then it beats the time offset in dateFrom and dateTo
  • See here the list for available time zones.
Berlin/Europe
regex optional, string Regular expression to filter the collection .*
folders optional, string collection of folder objects [{
"folder": "/sos",
"recursive": true
}]
limit optional, integer Restricts the number of responsed records, -1=unlimited 5000 10000
historyStates optional, array
contains SUCCESS, FAILED and/or INCOMPLETE
Only records with these states are responsed ["SUCCESS"]