User:Catlee/BuildAPI: Difference between revisions
Line 1: | Line 1: | ||
= REST Interface = | = REST Interface = | ||
List of request methods, urls, and parameters | == List of request methods, urls, and parameters == | ||
PUT and DELETE can also be achieved by POSTing to the URL with a POST field "_method" set to PUT or DELETE. | |||
GET /builds/branches -> list of branches | GET /builds/branches -> list of branches | ||
Line 41: | Line 42: | ||
* requestid (which request to rebuild) | * requestid (which request to rebuild) | ||
== Object definitions == | |||
Builds: | |||
* buildid | |||
* buildrequests | |||
* buildnumber | |||
* buildername | |||
* branch | |||
* revision | |||
* starttime | |||
* endtime | |||
* status | |||
Build Requests: | |||
* buildrequestid | |||
* buildername | |||
* branch | |||
* revision | |||
* submittime |
Revision as of 19:28, 30 September 2010
REST Interface
List of request methods, urls, and parameters
PUT and DELETE can also be achieved by POSTing to the URL with a POST field "_method" set to PUT or DELETE. GET /builds/branches -> list of branches
GET /builds/{branch} -> list of recent builds, including completed, running and pending
GET /builds/{branch}/build/{buildid} -> information about a particular build
GET /builds/{branch}/buildrequest/{requestid} -> information about a particular build request
GET /builds/{branch}/rev/{revision} -> list of builds for this revision
GET /builds/{branch}/builders -> list of valid builder names
GET /builds/{branch}/builders/{buildername} -> list of recent builds, including completed, running, and pending for this builder name
PUT /builds/{branch}/buildrequest/{requestid} -> update this build
- priority (required, sets the build request's priority)
DELETE /builds/{branch}/build/{buildid} -> cancel this build
DELETE /builds/{branch}/buildrequest/{requestid} -> cancel this buildrequest
- onlyifrunning (optional, set to only cancel builds if they're running)
- onlyifpending (optional, set to only cancel builds if they're pending)
DELETE /builds/{branch}/rev/{revision} -> cancel pending/running builds for this revision
- onlyifrunning (optional, set to only cancel builds if they're running)
- onlyifpending (optional, set to only cancel builds if they're pending)
- killmerged (optional, set to cancel builds that are merged with other revisions)
POST /builds/{branch}/rev/{revision} -> create a new build with this revision
- buildername (required, which builder to create builds for, can be specified multiple times)
POST /builds/{branch}/builders/{buildername} -> create a new build on this builder
- revision (optional, which revision to build)
POST /builds/{branch}/build -> rebuilds an old build on this branch
- buildid (this or requestid required, which build to rebuild)
- requestid (which request to rebuild)
Object definitions
Builds:
- buildid
- buildrequests
- buildnumber
- buildername
- branch
- revision
- starttime
- endtime
- status
Build Requests:
- buildrequestid
- buildername
- branch
- revision
- submittime