Get execution history of a job
get
/iam/governance/selfservice/api/v1/scheduler/jobs/{jobName}/history
Returns a paginated list of execution history details of a job.
Request
Path Parameters
-
jobName: string
Name of the job
Query Parameters
-
limit: integer
The numbers of items to return
-
offset: string
The number of items to skip before starting to collect the result set
-
orderBy: string
The sort field and the sort order in the format `field:order`. Available values of `field` are *startTime*, *endTime* and *status*. Available values of `order` are *desc* and *asc*.
Response
Supported Media Types
- application/json
200 Response
OK
Nested Schema : History
Type:
Show Source
object-
customStatus(optional):
string
-
errorMessage(optional):
string
-
exceptionObject(optional):
string
-
id(optional):
integer(int32)
-
jobEndTime(optional):
string(date-time)
Format: yyyy-MM-dd'T'HH:mm:ss'Z'
-
jobName(optional):
string
-
jobStartTime(optional):
string(date-time)
Format: yyyy-MM-dd'T'HH:mm:ss'Z'
-
params(optional):
array params
-
status(optional):
string
Allowed Values:
[ "STOPPED", "RUNNING", "INTERRUPTED", "FAILED" ]
400 Response
Invalid input
Examples
The following example shows how to retrieve a paginated list of execution history details of a job by submitting the GET request using cURL. The information shown here is against a pseudo system and serves as a prototype.
cURL Example
curl -i -X GET -u username:password \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ 'http://pseudo.com/iam/governance/selfservice/api/v1/scheduler/jobs/Catalog Synchronization Job/history?offset=0'
Example of Response Body
The following example shows the JSON response for a request for a list of execution history details of a job:
{
"links": [
{
"rel": "self",
"href": "http://pseudo.com/iam/governance/selfservice/api/v1/scheduler/jobs/Catalog%20Synchronization%20Job/history"
},
{
"rel": "self",
"href": "http://pseudo.com/iam/governance/selfservice/api/v1/scheduler/jobs/Catalog%20Synchronization%20Job/history?offset=0&limit=10"
},
{
"rel": "first",
"href": "http://pseudo.com/iam/governance/selfservice/api/v1/scheduler/jobs/Catalog%20Synchronization%20Job/history?offset=1&limit=10"
},
{
"rel": "prev",
"href": "http://pseudo.com/iam/governance/selfservice/api/v1/scheduler/jobs/Catalog%20Synchronization%20Job/history?offset=1&limit=10"
},
{
"rel": "next",
"href": "http://pseudo.com/iam/governance/selfservice/api/v1/scheduler/jobs/Catalog%20Synchronization%20Job/history?offset=10&limit=10"
}
],
"count": 10,
"hasMore": true,
"totalResult": 218,
"histories": [
{
"id": 20808,
"jobName": "Catalog Synchronization Job",
"infotype": "S",
"jobStartTime": "2022-08-23T07:13:51Z",
"jobEndTime": "2022-08-23T07:13:51Z",
"status": "STOPPED",
"params": {
"Process Entitlements": "true",
"Mode": "Incremental",
"Update Date": "",
"Process Roles": "false",
"Process Application Instances": "true",
"File Path": "",
"Updated Date": "08/23/2022 06:58:51"
}
},
{
"id": 20801,
"jobName": "Catalog Synchronization Job",
"infotype": "S",
"jobStartTime": "2022-08-23T06:58:51Z",
"jobEndTime": "2022-08-23T06:58:51Z",
"status": "STOPPED",
"params": {
"Process Entitlements": "true",
"Mode": "Incremental",
"Update Date": "",
"Process Roles": "false",
"Process Application Instances": "true",
"File Path": "",
"Updated Date": "08/23/2022 06:43:51"
}
},
{
"id": 20789,
"jobName": "Catalog Synchronization Job",
"infotype": "S",
"jobStartTime": "2022-08-23T06:43:51Z",
"jobEndTime": "2022-08-23T06:43:51Z",
"status": "STOPPED",
"params": {
"Process Entitlements": "true",
"Mode": "Incremental",
"Update Date": "",
"Process Roles": "false",
"Process Application Instances": "true",
"File Path": "",
"Updated Date": "08/23/2022 06:28:51"
}
},
{
"id": 20781,
"jobName": "Catalog Synchronization Job",
"infotype": "S",
"jobStartTime": "2022-08-23T06:28:51Z",
"jobEndTime": "2022-08-23T06:28:51Z",
"status": "STOPPED",
"params": {
"Process Entitlements": "true",
"Mode": "Incremental",
"Update Date": "",
"Process Roles": "false",
"Process Application Instances": "true",
"File Path": "",
"Updated Date": "08/23/2022 06:13:51"
}
},
{
"id": 20767,
"jobName": "Catalog Synchronization Job",
"infotype": "S",
"jobStartTime": "2022-08-23T06:13:51Z",
"jobEndTime": "2022-08-23T06:13:51Z",
"status": "STOPPED",
"params": {
"Process Entitlements": "true",
"Mode": "Incremental",
"Update Date": "",
"Process Roles": "false",
"Process Application Instances": "true",
"File Path": "",
"Updated Date": "08/23/2022 05:58:51"
}
},
{
"id": 20760,
"jobName": "Catalog Synchronization Job",
"infotype": "S",
"jobStartTime": "2022-08-23T05:58:51Z",
"jobEndTime": "2022-08-23T05:58:51Z",
"status": "STOPPED",
"params": {
"Process Entitlements": "true",
"Mode": "Incremental",
"Update Date": "",
"Process Roles": "false",
"Process Application Instances": "true",
"File Path": "",
"Updated Date": "08/23/2022 05:43:51"
}
},
{
"id": 20748,
"jobName": "Catalog Synchronization Job",
"infotype": "S",
"jobStartTime": "2022-08-23T05:43:51Z",
"jobEndTime": "2022-08-23T05:43:51Z",
"status": "STOPPED",
"params": {
"Process Entitlements": "true",
"Mode": "Incremental",
"Update Date": "",
"Process Roles": "false",
"Process Application Instances": "true",
"File Path": "",
"Updated Date": "08/23/2022 05:28:51"
}
},
{
"id": 20740,
"jobName": "Catalog Synchronization Job",
"infotype": "S",
"jobStartTime": "2022-08-23T05:28:51Z",
"jobEndTime": "2022-08-23T05:28:51Z",
"status": "STOPPED",
"params": {
"Process Entitlements": "true",
"Mode": "Incremental",
"Update Date": "",
"Process Roles": "false",
"Process Application Instances": "true",
"File Path": "",
"Updated Date": "08/23/2022 05:13:51"
}
},
{
"id": 20726,
"jobName": "Catalog Synchronization Job",
"infotype": "S",
"jobStartTime": "2022-08-23T05:13:51Z",
"jobEndTime": "2022-08-23T05:13:51Z",
"status": "STOPPED",
"params": {
"Process Entitlements": "true",
"Mode": "Incremental",
"Update Date": "",
"Process Roles": "false",
"Process Application Instances": "true",
"File Path": "",
"Updated Date": "08/23/2022 04:58:51"
}
},
{
"id": 20719,
"jobName": "Catalog Synchronization Job",
"infotype": "S",
"jobStartTime": "2022-08-23T04:58:51Z",
"jobEndTime": "2022-08-23T04:58:51Z",
"status": "STOPPED",
"params": {
"Process Entitlements": "true",
"Mode": "Incremental",
"Update Date": "",
"Process Roles": "false",
"Process Application Instances": "true",
"File Path": "",
"Updated Date": "08/23/2022 04:43:51"
}
}
],
"offset": 0,
"limit": 10
}