Метод getObjectMeta

Возвращает метаданные объекта.

Метод эквивалентен методу get, но в ответе отсутствует сам объект.

Запрос

HEAD /{bucket}/{key} HTTP/1.1

Path параметры

Параметр Описание
bucket Имя бакета.
key Ключ объекта.

Заголовки

Используйте в запросе необходимые общие заголовки.

Также в запросе можно использовать следующие заголовки:

Заголовок Описание
Range Определяет диапазон байт для загрузки из объекта.

Подробнее про заголовок Range читайте в спецификации HTTP http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35.
If-Modified-Since Если указан, то Object Storage возвращает:
- Объект. Если он изменялся после указанного времени.
- Код 304. Если объект не изменялся после указанного времени.

Если в запросе одновременно присутствуют заголовки If-Modified-Since и If-None-Match и проверки по ним разрешаются как If-Modified-Since -> true и If-None-Match -> false, то Object Storage возвращает код 304. Подробности смотрите в RFC 7232.
If-Unmodified-Since Если указан, то Object Storage возвращает:
- Объект. Если он не изменялся с указанного времени.
- Код 412. Если объект не изменялся с указанного времени.

Если в запросе одновременно присутствуют заголовки If-Unmodified-Since и If-Match и проверки по ним разрешаются как If-Unmodified-Since -> false и If-Match -> true, то Object Storage возвращает код 200 и запрошенные данные. Подробности смотрите в RFC 7232.
If-Match Если указан, то Object Storage возвращает:

- Объект. Если его ETag совпадает с переданным.
- Код 412. Если его ETag не совпадает с переданным.


Если в запросе одновременно присутствуют заголовки If-Unmodified-Since и If-Match и проверки по ним разрешаются как If-Unmodified-Since -> false и If-Match -> true, то Object Storage возвращает код 200 и запрошенные данные. Подробности смотрите в RFC 7232.
If-None-Match Если указан, то Object Storage возвращает:

- Объект. Если его ETag не совпадает с переданным.
- Код 304. Если его ETag совпадает с переданным.


Если в запросе одновременно присутствуют заголовки If-Modified-Since и If-None-Match и проверки по ним разрешаются как If-Modified-Since -> true и If-None-Match -> false, то Object Storage возвращает код 304. Подробности смотрите в RFC 7232.

Ответ

Заголовки

Помимо общих заголовков вы можете увидеть в ответе заголовки, перечисленные в таблице ниже.

Заголовок Описание
x-amz-meta-* Пользовательские метаданные объекта, сохраненные вместе объектом.
x-amz-storage-class Класс хранения объекта.
Имеет значение COLD, если объект находится в Холодном хранилище.

Если объект сохранен в Стандартном хранилище, то заголовка не будет.

Коды ответов

Перечень возможных ответов смотрите в разделе Ответы.