Chapter 3. Common REST API Functions

3.1. Using GET to Query Resources

This section describes how to use GET requests to query the Satellite server for various types of information. GET requests do not make any changes to Satellite resources, they only return information about resources.

3.1.1. Listing All Resources

Obtain a list of resources with a GET request on the collection URI obtained from the entry point.
Include an Accept HTTP header to define the MIME type for the response format.
GET /api/collection HTTP/1.1
Accept: MIME type

3.1.2. Determining the State of a Resource

Determine the state of a resource with a GET request on a URI obtained from a collection listing.
Include an Accept HTTP header to define the MIME type for the response format.
GET /api/collection/resource_id HTTP/1.1
Accept: MIME type