1.5. Requests

The REST API uses HTTP as a protocol to transfer a request for a resource representation from a client to the Red Hat Enterprise Virtualization Manager server:

GET /collection/resource HTTP/1.1
Host: www.example.com
Accept: application/xml

This follows the standard HTTP request message format including:

A Request-Line, which requires:
- a method e.g. GET;
- a URI e.g /collection/resource; and
- a HTTP version e.g HTTP/1.1.
A Header with fields to define parameters that process a request e.g. Host: and Accept:; and
An optional Message Entity depending on the request method.

Requests from a client to a server contain all necessary information to process the request without depending on any previous request or stored context on the server, which makes the REST API a stateless communication.