Общие заголовки запросов

Заголовок

Описание

Authorization

Любой запрос к Yandex Object Storage должен быть авторизован.

Вместе с этим заголовком обязательно надо использовать либо заголовок Date, либо заголовок X-Amz-Date.

О способах авторизации читайте в соответствующих разделах руководства.

Cache-Control

Набор директив для кеширования данных согласно RFC 2616.

Content-Disposition

Имя, под которым Object Storage предложит сохранить объект как файл при выгрузке. Соответствует RFC 2616.

Content-Encoding

Определяет кодировку содержимого согласно RFC 2616.

Content-Length

Длина тела запроса (без заголовков) в соответствии с RFC 2616.

Заголовок обязателен для всех запросов, которые передают в Object Storage какие-либо данные, например, при загрузке объекта.

Content-Type

Тип данных в запросе. Например, text/html. Подробнее про типы данных читайте в статье Википедии Список MIME-типов.

По умолчанию выставляется binary/octet-stream.

Content-MD5

128-битный MD5-хэш тела запроса, закодированный base64.

Соответствует спецификации RFC 1864.

Object Storage использует заголовок, чтобы убедиться, что отправленные данные соответствуют полученным.

Если в бакете настроены блокировки версий объектов по умолчанию, использовать заголовок Content-MD5 при загрузке или копировании версии объекта обязательно.

Date

Дата и время отправки запроса.

Формат: Thu, 18 Jan 2018 09:57:35 GMT.

Когда установлен X-Amz-Date, Object Storage игнорирует заголовок Date.

Expect

Ожидаемый код 100-continue.

Приложение при загрузке данных в Object Storage может использовать следующую логику:

• Отправлять запрос без тела, но с выставленным заголовком Expect: 100-continue.
• Отправлять запрос с телом после получения ответа 100-continue. В этом запросе заголовка Expect быть не должно.

Expires

Срок устаревания ответа. Соответствует RFC 2616.

Host

Хост-получатель запроса.

Заголовок необходим для HTTP/1.1, но необязателен для HTTP/1.0 запросов.

X-Amz-Date

Дата и время на источнике запроса.

Формат: 20211102T145822Z.

Когда установлен X-Amz-Date, Object Storage игнорирует заголовок Date.