Метод get
Возвращает объект из Object Storage.
Подробнее о подготовке к работе с API и общем виде запроса см. в разделе Как пользоваться S3 API.
Запрос
GET /{bucket}/{key} HTTP/2
Path параметры
| Параметр | Описание |
|---|---|
bucket |
Имя бакета. |
key |
Ключ объекта. |
Query параметры
| Параметр | Описание |
|---|---|
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 |
Ссылка на конкретную версию объекта. |
Заголовки
Используйте в запросе необходимые общие заголовки.
Также в запросе можно использовать следующие заголовки:
| Заголовок | Описание |
|---|---|
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, если объект находится в холодном хранилище, или ICE, если объект находится в ледяном хранилище.Если объект сохранен в стандартном хранилище, то заголовка не будет. |
X-Amz-Server-Side-Encryption |
Алгоритм шифрования, которым был зашифрован объект. Возвращается, если объект был загружен с включенным шифрованием. |
X-Amz-Server-Side-Encryption-Aws-Kms-Key-Id |
Идентификатор ключа KMS. Возвращается, если объект был загружен с включенным шифрованием. |
X-Amz-Object-Lock-Mode |
Тип временной блокировки, установленной на объект (если бакет версионируемый и в нем включен механизм блокировок):
На версию объекта может быть установлена только временная блокировка (заголовки |
X-Amz-Object-Lock-Retain-Until-Date |
Дата и время окончания временной блокировки в любом из форматов, описанных в стандарте HTTP. Например, Mon, 12 Dec 2022 09:00:00 GMT. Указывается только вместе с заголовком X-Amz-Object-Lock-Mode. |
X-Amz-Object-Lock-Legal-Hold |
Статус бессрочной блокировки, установленной на объект (если бакет версионируемый и в нем включен механизм блокировок):
На версию объекта может быть установлена только временная блокировка (заголовки |
Коды ответов
Перечень возможных ответов смотрите в разделе Ответы.