Describe a single builder.

More Help:

Parent's Help

Child Nodes

• builds (builds/help)
• slaves (slaves/help)
• pendingBuilds (pendingBuilds/help)

Flags:

• as_text
  • By default, application/json is used. Setting as_text=1 change the type to text/plain and implicitly sets compact=0 and filter=1. Mainly useful to look at the result in a web browser.
• compact
  • By default, the json data is compact and defaults to 1. For easier to read indented output, set compact=0.
• select
  • By default, most children data is listed. You can do a random selection of data by using select=<sub-url> multiple times to coagulate data. "select=" includes the actual url otherwise it is skipped.
• numbuilds
  • By default, only in memory cached builds are listed. You can as for more data by using numbuilds=<number>.
• filter
  • Filters out null, false, and empty string, list and dict. This reduce the amount of useless data sent.
• callback
  • Enable uses of JSONP as described in http://en.wikipedia.org/wiki/JSONP. Note that Access-Control-Allow-Origin:* is set in the HTTP response header so you can use this in compatible browsers.

Examples:

• /json
  • Root node, that *doesn't* mean all the data. Many things (like logs) must be explicitly queried for performance reasons.
• /json/builders/
  • All builders.
• /json/builders/master
  • A specific builder as compact text.
• /json/builders/master/builds
  • All *cached* builds.
• /json/builders/master/builds/_all
  • All builds. Warning, reads all previous build data.
• /json/builders/master/builds/509
  • Where 509 is either positive, a build number, or negative, a past build.
• /json/builders/master/builds/-1/source_stamp/changes
  • Build changes
• /json/builders/master/builds?select=-1&select=-2
  • Two last builds on 'master' builder.
• /json/builders/master/builds?select=-1/source_stamp/changes&select=-2/source_stamp/changes
  • Changes of the two last builds on 'master' builder.
• /json/builders/master/slaves
  • Slaves associated to this builder.
• /json/builders/master?select=&select=slaves
  • Builder information plus details information about its slaves. Neat eh?
• /json/slaves/nix-slave
  • A specific slave.
• /json?select=slaves/nix-slave/&select=project&select=builders/master/builds/509
  • A selection of random unrelated stuff as an random example. :)