The tree query parameter allows you to explicitly specify and retrieve only
the information you are looking for, by using an XPath-ish path expression.
The value should be a list of property names to include, with
sub-properties inside square braces. Try
tree=jobs[name],views[name,jobs[name]]
<http://ci.citizensnpcs.co/api/xml?tree=jobs[name],views[name,jobs[name]]> to
see just a list of jobs (only giving the name) and views (giving the name
and jobs they contain). *Note*: for array-type properties (such as jobs in
this example), the name must be given in the original plural, not in the
singular as the element would appear in XML (<job>). This will be more
natural for e.g. json?tree=jobs[name]
<http://ci.citizensnpcs.co/api/json?tree=jobs[name]> anyway: the JSON
writer does not do plural-to-singular mangling because arrays are
represented explicitly.
For array-type properties, a range specifier is supported. For example,
tree=jobs[name]{0,10} would retrieve the name of the first 10 jobs. The
range specifier has the following variants:
- *{M,N}*: From the M-th element (inclusive) to the N-th element
(exclusive).
- *{M,}*: From the M-th element (inclusive) to the end.
- *{,N}*: From the first element (inclusive) to the N-th element
(exclusive). The same as {0,N}.
- *{N}*: Just retrieve the N-th element. The same as {N,N+1}.
Another way to retrieve more data is to use the depth=N query parameter .
This retrieves all the data up to the specified depth. Compare depth=0
<http://ci.citizensnpcs.co/api/xml> and depth=1
<http://ci.citizensnpcs.co/api/xml?depth=1> and see what the difference is
for yourself. Also note that data created by a smaller depth value is
always a subset of the data created by a bigger depth value.
Because of the size of the data, the depth parameter should really be only
used to explore what data Jenkins can return. Once you identify the data
you want to retrieve, you can then come up with the tree parameter to
exactly specify the data you need.
Source: http://ci.citizensnpcs.co/api/
On Thursday, December 21, 2017 at 12:05:37 PM UTC-6, Raghav wrote:
>
> Hi,
>
>
>
> http://xxx/api/xml?&tree=builds[number,description,result,id,actions[parameters[name,
> va
> <http://xxx/api/xml?&tree=builds[number,description,result,id,actions[parameters[name,value]]]>
> lue]]]
> <http://xxx/api/xml?&tree=builds[number,description,result,id,actions[parameters[name,value]]]>
>
>
> Above API returns all the build IDs. Is there a way to limit results to
> get last 5 build IDS?
>
>
> Thanks,
>
> Raghav
>
--
You received this message because you are subscribed to the Google Groups
"Jenkins Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To view this discussion on the web visit
https://groups.google.com/d/msgid/jenkinsci-users/88e44b0d-688b-4437-9c1c-f25b298a0efb%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.
