User:Catlee/BuildAPI: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
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)


PUT and DELETE can also be achieved by POSTing to the URL with a POST field "_method" set to PUT or DELETE.
== 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