[Документация Yandex Cloud](../../../../index.md) > [Yandex Object Storage](../../../index.md) > Справочник API > [AWS S3 REST](../../index.md) > [REST](../index.md) > Object > HeadObject # Object Storage API, REST совместимый с Amazon S3: HeadObject Возвращает метаданные объекта. Метод эквивалентен методу [get](get.md), но в ответе отсутствует сам объект. Подробнее о подготовке к работе с API и общем виде запроса в разделе [Как пользоваться S3 API](../../index.md). ## Запрос {#request} ```http HEAD /{bucket}/{key} HTTP/2 ``` ### Path параметры {#path-parameters} Параметр | Описание ----- | ----- `bucket` | Имя бакета. `key` | Ключ объекта. ### Query параметры {#request-params} Параметр | Описание ----- | ----- `range` | Определяет диапазон байт для загрузки из объекта, например `?range=bytes=1-5`.

Если использовать совместно с заголовком `Range`, будет учитываться только значение заголовка. `response-content-type` | Устанавливает заголовок ответа `Content-Type`. `response-content-language` | Устанавливает заголовок ответа `Content-Language`. `response-expires` | Устанавливает заголовок ответа `Expires`. `response-cache-control` | Устанавливает заголовок ответа `Cache-Control`. `response-content-disposition` | Устанавливает заголовок ответа `Content-Disposition`. `response-content-encoding` | Устанавливает заголовок ответа `Content-Encoding`. `versionId` | Ссылка на конкретную версию объекта. ### Заголовки {#request-headers} Используйте в запросе необходимые [общие заголовки](../common-request-headers.md). Также в запросе можно использовать следующие заголовки: Заголовок | Описание ----- | ----- `Range` | Определяет диапазон байт для загрузки из объекта, например `--header 'Range: bytes=1-5'`.

Если использовать совместно с query-параметром `range`, будет учитываться только значение заголовка.

Подробнее про заголовок `Range` читайте в [RFC 9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-range). `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](https://tools.ietf.org/html/rfc7232). `If-Unmodified-Since` | Если указан, то Object Storage возвращает:
- Объект. Если он не изменялся с указанного времени.
- Код 412. Если объект изменялся с указанного времени.

Если в запросе одновременно присутствуют заголовки `If-Unmodified-Since` и `If-Match` и проверки по ним разрешаются как `If-Unmodified-Since -> false` и `If-Match -> true`, то Object Storage возвращает код 200 и запрошенные данные. Подробности смотрите в [RFC 7232](https://tools.ietf.org/html/rfc7232). `If-Match` | Если указан, то Object Storage возвращает:

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


Если в запросе одновременно присутствуют заголовки `If-Unmodified-Since` и `If-Match` и проверки по ним разрешаются как `If-Unmodified-Since -> false` и `If-Match -> true`, то Object Storage возвращает код 200 и запрошенные данные. Подробности смотрите в [RFC 7232](https://tools.ietf.org/html/rfc7232). `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](https://tools.ietf.org/html/rfc7232). ## Ответ {#response} ### Заголовки {#response-headers} Помимо [общих заголовков](../common-response-headers.md) вы можете увидеть в ответе заголовки, перечисленные в таблице ниже. Заголовок | Описание ----- | ----- `X-Amz-Meta-*` | Пользовательские метаданные объекта. `X-Amz-Storage-Class` | [Класс хранилища](../../../concepts/storage-class.md) объекта.
Имеет значение `COLD`, если объект находится в холодном хранилище, `ICE`, если объект находится в ледяном хранилище.

Если объект сохранен в стандартном хранилище, то заголовка не будет. `X-Amz-Server-Side-Encryption` | Алгоритм шифрования, которым был зашифрован объект. Возвращается, если объект был загружен с включенным [шифрованием](../../../operations/buckets/encrypt.md). `X-Amz-Server-Side-Encryption-Aws-Kms-Key-Id` | Идентификатор [ключа KMS](../../../../kms/concepts/key.md). Возвращается, если объект был загружен с включенным [шифрованием](../../../operations/buckets/encrypt.md). `X-Amz-Object-Lock-Mode` |

Тип временной [блокировки](../../../concepts/object-lock.md), установленной на объект (если бакет [версионируемый](../../../concepts/versioning.md) и в нем включен механизм блокировок):

На версию объекта может быть установлена только временная блокировка (заголовки `X-Amz-Object-Lock-Mode` и `X-Amz-Object-Lock-Retain-Until-Date`), только бессрочная блокировка (`X-Amz-Object-Lock-Legal-Hold`) или обе сразу. Подробнее об их совместной работе в разделе [Типы блокировок](../../../concepts/object-lock.md#types).

`X-Amz-Object-Lock-Retain-Until-Date` | Дата и время окончания временной блокировки в любом из форматов, описанных в [стандарте HTTP](https://www.rfc-editor.org/rfc/rfc9110#name-date-time-formats). Например, `Mon, 12 Dec 2022 09:00:00 GMT`. Указывается только вместе с заголовком `X-Amz-Object-Lock-Mode`. `X-Amz-Object-Lock-Legal-Hold` |

Статус бессрочной [блокировки](../../../concepts/object-lock.md), установленной на объект (если бакет [версионируемый](../../../concepts/versioning.md) и в нем включен механизм блокировок):

На версию объекта может быть установлена только временная блокировка (заголовки `X-Amz-Object-Lock-Mode` и `X-Amz-Object-Lock-Retain-Until-Date`), только бессрочная блокировка (`X-Amz-Object-Lock-Legal-Hold`) или обе сразу. Подробнее об их совместной работе в разделе [Типы блокировок](../../../concepts/object-lock.md#types).

### Коды ответов {#response-codes} Перечень возможных ответов смотрите в разделе [Ответы](../response-codes.md). #### Связанные статьи {#related-articles} * [Объект](../../../concepts/object.md) * [Получение информации об объекте](../../../operations/objects/info.md) #### Полезные ссылки {#see-also} * [Начало работы с AWS S3 API в Yandex Object Storage](../../s3-api-quickstart.md) * [Отладка запросов с помощью утилиты AWS CLI](../../signing-requests.md#debugging) * [Пример отправки подписанного запроса с помощью утилиты curl](../../../api-ref/authentication.md#s3-api-example) * [Пример кода для генерации подписи](../../../concepts/pre-signed-urls.md#code-examples)