User:Catlee/BuildAPI: Difference between revisions
Line 1: | Line 1: | ||
= REST Interface = | = REST Interface = | ||
List of request methods, urls, and parameters: | |||
GET /builds/branches -> list of branches | GET /builds/branches -> list of branches | ||
Line 13: | Line 15: | ||
GET /builds/{branch}/builders/{buildername} -> list of recent builds, including completed, running, and pending for this builder name | GET /builds/{branch}/builders/{buildername} -> list of recent builds, including completed, running, and pending for this builder name | ||
PUT /builds/{branch}/build/{buildid} -> update this build ( | PUT /builds/{branch}/build/{buildid} -> update this build | ||
* priority (required, sets the build request's priority) | |||
DELETE /builds/{branch}/build/{buildid} -> cancel this build ( | DELETE /builds/{branch}/build/{buildid} -> cancel this build | ||
* onlyifrunning (optional, set to only cancel builds if they're running) | |||
* onlyifpending (optional, set to only cancel builds if they're pending) | |||
POST /builds/{branch}/rev/{revision} -> create a new build with this revision ( | 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 (optional revision | 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 ( | POST /builds/{branch}/build -> rebuilds an old build on this branch | ||
* buildid (required, which build to rebuild) | |||
PUT and DELETE can also be achieved by POSTing to the URL with a POST field "_method" set to PUT or DELETE. | PUT and DELETE can also be achieved by POSTing to the URL with a POST field "_method" set to PUT or DELETE. |
Revision as of 19:39, 29 September 2010
REST Interface
List of request methods, urls, and parameters:
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}/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}/build/{buildid} -> update this build
- priority (required, sets the build request's priority)
DELETE /builds/{branch}/build/{buildid} -> cancel this build
- onlyifrunning (optional, set to only cancel builds if they're running)
- onlyifpending (optional, set to only cancel builds if they're pending)
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 (required, which build to rebuild)
PUT and DELETE can also be achieved by POSTing to the URL with a POST field "_method" set to PUT or DELETE.