7.2.2.  Listing Extended Resource Sub-Collections

The API extends collection representations to include sub-collections when the Accept header includes the detail parameter.
GET /api/collection HTTP/1.1
Accept: application/xml; detail=subcollection
This includes multiple sub-collection requests using either separated detail parameters:
GET /api/collection HTTP/1.1
Accept: application/xml; detail=subcollection1; detail=subcollection2
Or one detail parameter that separates the sub-collection with the + operator:
GET /api/collection HTTP/1.1
Accept: application/xml; detail=subcollection1+subcollection2+subcollection3
The API supports extended sub-collections for the following main collections.

Table 7.4. Collections that use extended sub-collections

Collection Extended Sub-Collection Support
hosts statistics
vms statistics, nics, disks

Example 7.1. An request for extended statistics, nics and disks sub-collections in the vms collection

GET /api/vms HTTP/1.1
Accept: application/xml; detail=statistics+nics+disks