getObjectMeta method

Returns object metadata.

The method is equivalent to get, but the object itself is not included in the response.

Request

HEAD /{Key} HTTP/1.1

Path parameters

Parameter Description
bucket Bucket name.
key Object key.

Headers

In a request, use the necessary common request headers.

You can also use the following headers in requests:

Header name Description
Range Sets the byte range to be uploaded from the object.

For more information about the Range header, see the HTTP specification http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35.
If-Modified-Since If specified, Object Storage returns:
- The object. If it has been modified since the specified time.
- Code 304. If the object has not been modified since the specified time.

If a request has both the If-Modified-Since and If-None-Match headers and their checks result in If-Modified-Since -> true and If-None-Match -> false, then Object Storage returns 304. For more information, see RFC 7232.
If-Unmodified-Since If specified, Object Storage returns:
- The object. If it has not been modified since the specified time.
- Code 412. If the object has not been modified since the specified time.

If a request has both the If-Unmodified-Since and If-Match headers and their checks result in If-Unmodified-Since -> false and If-Match -> true, then Object Storage returns 200 and the requested data. For more information, see RFC 7232.
If-Match If specified, Object Storage returns:

- The object. If its ETag matches the sent one.
- Code 412. If its ETag doesn't match the sent one.


If a request has both the If-Unmodified-Since and If-Match headers and their checks result in If-Unmodified-Since -> false and If-Match -> true, then Object Storage returns 200 and the requested data. For more information, see RFC 7232.
If-None-Match If specified, Object Storage returns:

- The object. If its ETag doesn't match the sent one.
- Code 304. If its ETag matches the sent one.


If a request has both the If-Modified-Since and If-None-Match headers and their checks result in If-Modified-Since -> true and If-None-Match -> false, then Object Storage returns 304. For more information, see RFC 7232.

Response

Headers

In addition to common response headers, responses may have headers listed in the table below.

Header name Description
x-amz-meta-* User-defined object metadata that is stored with the object.
x-amz-storage-class COLD object storage class if the object is stored in the cold storage.

If it is stored in the standard storage, there will be no header.

Response codes

For a list of possible responses, see Responses.