Get a job's build status
get
/v1/jobs/{jobName}/builds/{buildNumber}/status
Returns the status of the build
Request
Path Parameters
-
buildNumber: string
build number
-
jobName: string
job name
Response
Supported Media Types
- text/plain
200 Response
Job build status
400 Response
ERROR: Job identified by {jobIdentifier} no longer exists
401 Response
ERROR: Not authorized
Examples
The following example shows how to retrieve the status of a build (40) by submitting a GET request on the REST resource using curl.
curl -X GET -u alex.admin https://myinstance.oracle.com/myorg/rest/myorg_bobtest_1/cibuild/v1/jobs/JOBID-1/builds/40/status Enter host password for user 'alex.admin': SUCCESSFUL
The retrieved status indicates that the build of the job completed successfully.
Any of the following statuses could be returned:
- UNKNOWN
- BUILDING
- SUCCESSFUL
- FAILED
- POSTFAILED
- CANCELED
- ABORTED
- RESCHEDULED
A {jobName}
can be used instead of {jobIdentifer}
.
Errors
If the job can't be found, you'll see one of the following error messages:
ERROR: Job {jobName} no longer exists ERROR: Job identified by {jobIdentifier} no longer exists
If the job has no builds, you'll see the following error message:
ERROR: No build {buildNumber} for job {jobName}