HCP Tenant Management Help


Common response headers

Some response headers are common to all HSwift requests, while some are specific to certain requests. The table below describes some of the common response headers.

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 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 Mat 2013 14:27:05 GMT

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.

X-Trans-Id HCP returns a universally unique identifier (UUID). This UUID does not map to any entries in the HCP database.

Some common response headers address browser security concerns. These headers have fixed values. The table below describes these headers.

Header Value Description
Cache-Control no-cache,no-store,must-
  revalidate
Specifies directives that must be obeyed by all caching mechanisms along the request/response chain
Content-Security-
  Policy
default-src 'self'; script-src
  'self' 'unsafe-eval' 'unsafe-
  inline'; connect-src 'self';
  img-src 'self'; style-src 'self'
  'unsafe-inline'; object-src
  'self'; frame-ancestors 'self';
Restricts the content that the browser can load to the sources specified by the header value
Expires Thu, 01 Jan 1970 00:00:00
  GMT
Causes the response to become stale immediately after it is sent
Pragma no-cache Prevents the response from being used for subsequent requests for the same resource without the browser first checking whether the resource has changed
X-Content-Type-
  Options
nosniff Prevents the browser from examining the returned content to determine the content MIME type
X-DNS-Prefetch-
  Control
off Prevents the browser from performing domain name resolution on URLs embedded in returned content before the URLs are requested
X-Download-
  Options
noopen Prevents the browser from opening resources that are downloaded through links in the returned content
X-Frame-Options SAMEORIGIN Prevents the browser from rendering the returned content in a frame on a page containing content not returned by the HCP system
X-XSS-Protection 1; mode=block Stops the browser from loading the returned content if the browser detects reflected cross-site scripting (XSS) in the response

For information about request-specific response headers, see the "Response header" topic for each type of operation you can perform with the HSwift API.

Notes: 

HCP can also return several standard HTTP response headers that are not described in this book. Among others, these include Connection, Content-Disposition, Content-Encoding, and Content-Language. For more information about HTTP response headers, see the HTTP/1.1 standards (RFCs 7230 through 7237).

The Cache-Control and Expires headers are not returned with error responses.

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.