JOC API

Version 1.13.10

Download RAML
JOC API
/jobs
POST

Returns a collection of jobs (volatile part) filtered by a period or job state


Parameters in the POST body schema

Name Type Description Example Default
jobschedulerId required, string JobScheduler Master ID scheduler
compact optional, boolean Response has a compact version if this parameter is true false
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, array collection of folder objects [{
"folder": "/sos",
"recursive": true
}]
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"
}]
isOrderJob optional; boolean Determines if the specified job is an order job or not.
states optional, array Filters all jobs with states such as:
  • PENDING
  • RUNNING
  • WAITINGFORRESOURCE
  • STOPPED
["WAITINGFORRESOURCE", "STOPPED"]
withoutDuration optional, boolean If true the expected duration will not be estimated false