Get Job
Retrieves a job by id, according to the Job interface in the engine.
Method
GET /job/{id}
Parameters
Path Parameters
| Name | Description |
|---|---|
| id | The id of the job to be retrieved. |
Result
A JSON object corresponding to the Job interface in the engine.
Its properties are as follows:
| Name | Value | Description |
|---|---|---|
| id | String | The id of the job. |
| jobDefinitionId | String | The id of the associated job definition. |
| dueDate | String | The date on which this job is supposed to be processed. |
| processInstanceId | String | The id of the process instance which execution created the job. |
| executionId | String | The specific execution id on which the job was created. |
| processDefinitionId | String | The id of the process definition which this job belongs to. |
| processDefinitionKey | String | The key of the process definition which this job belongs to. |
| retries | Number | The number of retries this job has left. |
| exceptionMessage | String | The message of the exception that occurred, the last time the job was executed. Is null when no exception occurred. |
| failedActivityId | String | The id of the activity on which the last exception occurred, the last time the job was executed. Is null when no exception occurred. |
| suspended | Boolean | A flag indicating whether the job is suspended or not. |
| priority | Number | The job's priority for execution. |
| tenantId | String | The id of the tenant which this job belongs to. |
| createTime | String | The date on which this job has been created. |
Response Codes
| Code | Media type | Description |
|---|---|---|
| 200 | application/json | Request successful. |
| 404 | application/json | Job with given id does not exist. See the Introduction for the error response format. |
Example
Request
GET /job/aJobId
Response
{
"id": "aJobId",
"jobDefinitionId": "f9eec330-e3ff-11e8-8f7d-e4a7a094a9d6",
"dueDate": "2018-07-17T17:00:00+0200",
"processInstanceId": "aProcessInstanceId",
"processDefinitionId": "timer:1:f9ee9c1f-e3ff-11e8-8f7d-e4a7a094a9d6",
"processDefinitionKey": "timer",
"executionId": "anExecutionId",
"retries": 0,
"exceptionMessage": "An exception Message",
"failedActivityId": "anActivityId",
"suspended": false,
"priority": 10,
"tenantId": null,
"createTime": "2018-05-05T17:00:00+0200"
}