2.2.7.2.12 RetrieveMediaResource Request
A RetrieveMediaResource Request is used by a client to retrieve an AtomPub Media Resource, as specified in [RFC5023] section 9.6, that maps to a BLOB associated with an EntityType instance, as described in Abstract Data Model (section 2.2.1). A request of this type is defined by AtomPub [RFC5023] section 9.6. This section adds constraints to those defined in AtomPub for this request type.
If the RetrieveMediaResource Request was successful, the response payload MUST contain the requested representation of the media resource identified in the request URI. If the RetrieveMediaResource Request is not successful (for example, an error occurred while processing the request), the response MUST be formatted according to Error Response (section 2.2.8.1).
The syntax of a RetrieveMediaResource Request is defined as follows:
-
retrieveMR-Req = retrieveMR-ReqLine retrieveEntity-ReqHeaders CRLF retrieveMR-ReqLine = "GET" SP entityTypeInstanceMRUri retrieveEntity-QueryOps SP HTTP-Version CRLF retrieveEntity-ReqHeaders = ; section 2.2.7.2.2 retrieveEntity-QueryOps = ; section 2.2.7.2.2 entityTypeInstanceMRUri = ; see section 2.2.7.3.5
The syntax of a response to a successful RetrieveMediaResource Request is defined as follows:
-
retrieveMR-Resp = Status-Line ; see [RFC2616] section 6.1.1 retrieveEntity-RespHeaders CRLF retrieveMR-RespBody retrieveEntity-RespHeaders = ; section 2.2.7.2.2 retrieveMR-RespBody = <Any valid HTTP response body>