User:Catlee/BuildAPI: Difference between revisions
| Line 34: | Line 34: | ||
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) | * buildername (required, which builder to create builds for, can be specified multiple times) | ||
* properties (optional, extra properties for this build) | |||
POST /builds/{branch}/builders/{buildername} -> create a new build on this builder | POST /builds/{branch}/builders/{buildername} -> create a new build on this builder | ||
* revision (optional, which revision to build) | * revision (optional, which revision to build) | ||
* properties (optional, extra properties for this build) | |||
POST /builds/{branch}/build -> rebuilds an old build on this branch | POST /builds/{branch}/build -> rebuilds an old build on this branch | ||
* buildid (this or requestid required, which build to rebuild) | * buildid (this or requestid required, which build to rebuild) | ||
* requestid (which request to rebuild) | * requestid (which request to rebuild) | ||
* properties (optional, extra properties for this build) | |||
== Object definitions == | == Object definitions == | ||
Revision as of 20:33, 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)
- properties (optional, extra properties for this build)
POST /builds/{branch}/builders/{buildername} -> create a new build on this builder
- revision (optional, which revision to build)
- properties (optional, extra properties for this 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)
- properties (optional, extra properties for this build)
Object definitions
Builds:
- buildid
- buildrequests
- buildnumber
- buildername
- branch
- revision
- starttime
- endtime
- status
Build Requests:
- buildrequestid
- buildername
- branch
- revision
- submittime