HeadObject
Last updated
Last updated
Returns the metadata of the object.
The method is equivalent to the GetObject method , but the object itself is missing from the response.
Use the required common headers in the request .
You can also use the following headers in the request:
In addition to the general headers, you can see the headers listed in the table below in the response.
For a list of possible answers, see the Answers section .
Parameter
Description
bucket
Bucket name.
key
Object key.
Heading
Description
Range
Specifies the range of bytes to load from the object. Read more about the Range header in the HTTP specification http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35 .
If-Modified-Since
If specified, ColdStack returns:
- Object. If it changed after the specified time.
- Code 304. If the object has not changed after the specified time.
If the query at the same time there are headers If-Modified-Sinceand If-None-Matchand check it settled like If-Modified-Since -> trueand If-None-Match -> falsethen ColdStack returns the code 304. For details, see RFC 7232 .
If-Unmodified-Since
If specified, ColdStack returns:
- Object. If it hasn't changed since the specified time.
- Code 412. If the object has not changed since the specified time.
If the request headers are present simultaneously If-Unmodified-Sinceand If-Matchresolved as checks on them If-Unmodified-Since -> false, and If-Match -> truethen ColdStack returns a code 200, and the requested data. See RFC 7232 for details .
If-Match
If specified, ColdStack returns:
- Object. If it ETagmatches the one passed.
- Code 412. If it ETagdoes not match the transmitted one.
If the request headers are present simultaneously If-Unmodified-Sinceand If-Matchresolved as checks on them If-Unmodified-Since -> false, and If-Match -> truethen ColdStack returns a code 200, and the requested data. See RFC 7232 for details .
If-None-Match
If specified, ColdStack returns:
- Object. If its ETagnot the same as the one passed.
- Code 304. If it ETagmatches the transmitted one.
If the query at the same time there are headers If-Modified-Sinceand If-None-Matchand check it settled like If-Modified-Since -> trueand If-None-Match -> falsethen ColdStack returns the code 304. For details, see RFC 7232 .
Heading
Description
x-amz-meta-*
The custom metadata of the object, saved with the object.
x-amz-storage-class
Object storage class.
Matters COLDif the object is in Cold Storage.
If the object is saved in the Standard storage, then there will be no title.
x-amz-server-side-encryption
The encryption algorithm used to encrypt the object. Returned if the object was loaded with encryption enabled .
x-amz-server-side-encryption-aws-kms-key-id
KMS key identifier . Returned if the object was loaded with encryption enabled .