- URL:
- https://<root>/system/jobs/<jobID>
- Methods:
GET
- Required Capability:
- Access allowed with any authorized privilege
- Version Introduced:
- 10.1
Description
An individual job resource returns the current progress for a current or previously run job. A job represents the asynchronous execution of an operation. Progress information can be acquired by periodically querying this resource.
Request parameters
Parameter | Details |
---|---|
| The response format. The default response format is Values: |
Example usage
The following is a sample request URL used to access an individual job resource:
https://machine.domain.com/webadaptor/admin/system/jobs/jcbdbf7aa-385e-417a-b629-29a310895b9b?f=pjson
JSON Response syntax
{
"jobid": "<jobID>",
"status": "<status>",
"totalsteps": <total steps>,
"currentstep": <current step>,
"stepInfo": [ "<msg1>", "<msg2>", ...],
"operationResponse": <operation response>
}
JSON Response example
{
"jobid": "jcbdbf7aa-385e-417a-b629-29a310895b9b",
"status": "COMPLETED",
"totalsteps": 3,
"currentstep": 3,
"stepInfo": [
"Stopping the service 'USA' on machine 'MACHINE.DOMAIN.COM'",
"Saving edits to the configuration store",
"Starting the service 'USA' on machine 'MACHINE.DOMAIN.COM'",
"Stopping the service 'USA' on machine 'MACHINE.DOMAIN.COM'"
],
"operationResponse": {
"status": "error","messages": [
"service failed to start"
],
"detail": {
"service": "USA.MapServer",
"state": "FAILED",
"message": "",
"machines": [
{
"machine": "MACHINE.DOMAIN.COM",
"state": "FAILED","reports": [
{
"state": "FAILED",
"message": "Cannot open file \\server\share\USA.MSD.
The system cannot find the file specified or it is inaccessible to the server."
}
]
}
]
}
}
}