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>