PUT object request headers

The table below describes the headers you can use in a request to store an object.

Name Type Description
X-Auth-Token String See, Common request headers
Content-Encoding String Specifies whether the request body is compressed. If so, enter gzip.
Content-Length Integer Specifies the size, in bytes, of the data being stored.
Etag String

This value is the MD5 checksum of the object content.

It is recommended to compute the MD5 checksum of the file being uploaded and include the value in this header. HCP fails the transaction if the MD5 of the file received did not matched this value.

Expect String Use the Expect header with the value of 100-Continue in combination with the If-None-Match header with the value set to an asterisk (*) to query whether the server already has an object of the same name before any data is sent.
If-None-Match String

Specifies one or more values for comparison with the ETag of the specified source object. If the ETag doesn't match any of the specified values, HCP continues processing the request. If the ETag matches any of the specified values, HCP returns a 412 (Precondition Failed) status code.

To specify the values for this header, use this format:

"value"[, "value"]...

In this format, each value can be any string of more characters and must be enclosed in double quotation marks (").

Alternatively, you can specify a single asterisk (*) as the value of the If-None-Match header. No ETags match an asterisk in an If-None-Match header.

Transfer-Encoding String If this header is used, always set to chunked. This header should be used if HCP cannot determine the size of the response body before formulating the response.
X-Copy-From String

Specifies the source container and object in this format:

     /container-name/source-object-name

You must UTF-8-encode and then URL-encode the names of the container and object before you include them in the header. Using X-Copy-From locates the source object to copy, and when it is used in conjecture with a PUT command X-Copy-From has the same effect as using the COPY operation to copy an object.

For more information on the COPY method, see Copying an object.

X-Object-Meta-name String For objects only, specifies a custom metadata property/value pair. The response headers include one X-Object-Meta- header for each applicable pair. For more information on this header, see Custom metadata

Trademark and LegalDisclaimer

© 2015 Hitachi Data Systems Corporation. All rights reserved.