The table below describes the headers you can use in a request to retrieve an object.
Name | Type | Description |
---|---|---|
X-Auth-Token | String | See, Common request headers |
If-Match | Dict |
Specifies one or more values for comparison with the ETag of the specified item. If the ETag matches one of the specified values, HCP continues processing the request. If the ETag doesn't match any of the specified values, HCP returns a 412 (Preconditions 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 one or more characters and must be enclosed in double quotation marks ("). Alternatively, you can specify a single asterisk (*) as the value for the If-Match header. All ETags match an asterisk in an If-Match header. |
If-None-Match | String |
Specifies one or more values for comparison with the ETag of the specified object. If the ETag matches any of the specified values, HCP returns a 304 (Not Modified) status code. To specify the values for this header, use this format: "value"[, "value"]... In this format, each value can be any string of one or more characters and must be enclosed in double quotation marks ("). Alternatively, you can specify a single asterisk (*) as the value for the If-None-Match header. No ETags match an asterisk in an If-None-Match header. |
If-Modified-Since | Dict |
Specifies a date and time, in Greenwich Mean Time (GMT), for comparison with the date and time the specified object was last modified. If the modification date and time is later than the specified date and time, HCP continues processing the request. If the modification date and time is equal to or earlier than the specified date and time, HCP returns a 304 (Not Modified) status code. To specify the date and time for this header, use one of these formats: • DDD, dd MMM yyyy HH:mm:ss(+0000|GMT) For example: Thu, 07 Mar 2013 14:27:05 +0000 •DDDD, dd-MMM-yy HH:mm:ss(+0000|GMT) For example: Thursday, 07-Mar-13 14:27:05 +0000 •DDD MMM d HH:mm:ss yyyy For example: Thu Mar 7 14:27:05 2013 In these formats: •DDD is the three-letter abbreviation for the day of the week, with an uppercase first letter (for example, Mon). •DDDD is the day of the week fully spelled out, with an uppercase first letter (for example, Monday). •d is the one- or two-digit day of the month, as applicable. • dd is the two-digit day of the month. •MMM is the three-letter abbreviation for the month, with an uppercase first letter (for example, Feb). •yy is the last two digits of the year. |
If-Unmodified-Since | Dict |
Specifies a date and time, in Greenwich Mean Time (GMT), for comparison with the date and time the specified object was last modified. If the modification date and time is equal to or earlier than the specified date and time, HCP continues processing the request. If the modification date and time is later than the specified date and time, HCP returns a 412 (Precondition Failed) status code. For valid values for this header, see the description of the If-Modified-Since header above. |
Range | Dict | Retrieves part of an object. For valid values for this header, see Retrieving an object |
© 2016 Hitachi Data Systems Corporation. All rights reserved.