< Previous | Contents | Next >

Common response headers

Some response headers are common to all HS3 requests. The table below describes those headers. Response headers that are specific to certain requests are described in the sections for those requests in Chapter 5, “Working with buckets,” on page 65 and Chapter 6, “Working with objects,” on page 125.


Response header

Description

Content-Length

The size, in bytes, of the response body if HCP can determine the size before formulating the response.


If the response does not include a response body, the value of the Content-Length header is 0 (zero).

Content-Type

The Internet media type of the response body if HCP can determine the Internet media type. If HCP cannot determine the Internet media type, the value of this header is application/octet-stream.


Because HCP returns error information in a response body, the response to any request can include a Content-Type header.

Date

The date and time at which HCP responded to the request, in Greenwich Mean Time (GMT). The date and time are returned in this format:


DDD dd MMM yyyy HH:mm:ss GMT


For example:


Thu, 14 Mar 2013 14:27:05 GMT

Server

The system that responded to the request. The value of this header is always HCP followed by the HCP version number (for example, HCP V7.0.0.16).

Transfer-Encoding

Always chunked. This header is returned if the response includes a response body but HCP cannot determine the size of the response body before formulating the response.


Because HCP returns error information in a response body, the response to any request can include a Transfer-Encoding header.


58 Chapter 4: Requests and responses

Responses


image

image

Note: HCP also returns several standard HTTP response headers that are not described in this book. Among others, these include Cache-Control, Connection, Content-Disposition, Content-Encoding, Content-Language, Expires, and Pragma. For more information on HTTP response headers, see http://www.w3.org/Protocols/rfc2616/rfc2616.html.

image