get-object

Описание

Получает объект из Amazon S3.

В запросе GetObject укажите полное имя ключа объекта.

Ведра общего назначения - Поддерживаются как запросы в стиле виртуального хостинга, так и запросы в стиле пути. Например, для запроса в стиле виртуального хостинга, если у вас есть объект photos/2006/February/sample.jpg , укажите имя ключа объекта как /photos/2006/February/sample.jpg . Для запроса в стиле пути, если у вас есть объект photos/2006/February/sample.jpg в ведре с именем examplebucket , укажите имя ключа объекта как /examplebucket/photos/2006/February/sample.jpg . Дополнительную информацию о типах запросов см. в разделе Задание заголовка HTTP Host для спецификации ведра в руководстве пользователя Amazon S3.

Ведра каталогов - Поддерживаются только запросы в стиле виртуального хостинга. Например, для запроса в стиле виртуального хостинга, если у вас есть объект photos/2006/February/sample.jpg в ведре с именем amzn-s3-demo-bucket--usw2-az1--x-s3 , укажите имя ключа объекта как /photos/2006/February/sample.jpg . Также при выполнении запросов к этому API-операции ваши запросы отправляются на зоновые конечные точки. Эти конечные точки поддерживают запросы в стиле виртуального хостинга в формате ``https://bucket-name .s3express-zone-id .*region-code* .amazonaws.com/key-name `` . Запросы в стиле пути не поддерживаются. Дополнительную информацию о конечных точках в зонах доступности см. в разделе Региональные и зоновые конечные точки для ведер каталогов в зонах доступности в руководстве пользователя Amazon S3. Дополнительную информацию о конечных точках в локальных зонах см. в разделе Концепции для ведер каталогов в локальных зонах в руководстве пользователя Amazon S3.

Разрешения

Разрешения на ведра общего назначения - Необходимо иметь требуемые разрешения в политике. Чтобы использовать GetObject , необходимо иметь разрешение READ на доступ к объекту (или версии). Если вы предоставляете разрешение READ анонимному пользователю, операция GetObject возвращает объект без использования заголовка авторизации. Дополнительную информацию см. в разделе Указание разрешений в политике в руководстве пользователя Amazon S3. Если вы включаете versionId в заголовок запроса, необходимо иметь разрешение s3:GetObjectVersion на доступ к определенной версии объекта. Разрешение s3:GetObject в этом случае не требуется. Если вы запрашиваете текущую версию объекта без указанного versionId в заголовке запроса, необходимо только разрешение s3:GetObject . Разрешение s3:GetObjectVersion в этом случае не требуется. Если запрашиваемый объект не существует, ошибка, возвращаемая Amazon S3, зависит от наличия разрешения s3:ListBucket.
- Если у вас есть разрешение s3:ListBucket на ведро, Amazon S3 возвращает ошибку HTTP-код состояния 404 Not Found.
- Если у вас нет разрешения s3:ListBucket, Amazon S3 возвращает ошибку HTTP-код состояния 403 Access Denied.
Разрешения на ведра каталогов - Чтобы предоставить доступ к этому API-операции для ведра каталога, рекомендуется использовать операцию ` CreateSession https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html`__ для авторизации на основе сеанса. В частности, вы предоставляете разрешение s3express:CreateSession для ведра каталога в политике ведра или политике на основе идентификатора IAM. Затем вы выполняете вызов API CreateSession на ведре для получения маркера сеанса. С маркером сеанса в заголовке запроса вы можете выполнять запросы API к данной операции. После истечения срока действия маркера сеанса вы выполняете еще один вызов API CreateSession для генерации нового маркера сеанса. Amazon Web Services CLI или SDK автоматически создают сеанс и обновляют маркер сеанса, чтобы избежать прерываний службы при истечении срока действия сеанса. Дополнительную информацию об авторизации см. в разделе ` CreateSession https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html`__ . Если объект зашифрован с помощью SSE-KMS, вам также должны быть предоставлены разрешения kms:GenerateDataKey и kms:Decrypt в политиках на основе идентификатора IAM и политиках ключей KMS для ключа KMS.

Классы хранения

Если объект, который вы получаете, хранится в классе хранения S3 Glacier Flexible Retrieval, классе хранения S3 Glacier Deep Archive, классе доступа к архивам S3 Intelligent-Tiering или классе доступа к глубокому архиву S3 Intelligent-Tiering, перед получением объекта вы должны сначала восстановить копию с помощью RestoreObject. В противном случае эта операция возвращает ошибку InvalidObjectState. Сведения о восстановлении архивированных объектов см. в руководстве пользователя Amazon S3 в разделе Восстановление архивированных объектов.

Ведра каталогов - Ведра каталогов поддерживают только EXPRESS_ONEZONE (класс хранения S3 Express One Zone) в зонах доступности и ONEZONE_IA (класс хранения S3 One Zone-Infrequent Access) в выделенных локальных зонах. Значения неподдерживаемых классов хранения не запишут целевой объект и ответят HTTP-кодом состояния 400 Bad Request.

Шифрование

Заголовки запроса шифрования, такие как x-amz-server-side-encryption, не должны отправляться для запросов GetObject, если ваш объект использует шифрование на стороне сервера с управляемыми Amazon S3 ключами шифрования (SSE-S3), шифрование на стороне сервера с ключами управления ключами (KMS) (SSE-KMS) или двухуровневое шифрование на стороне сервера с ключами Amazon Web Services KMS (DSSE-KMS). Если вы включаете заголовок в своих запросах GetObject для объекта, использующего эти типы ключей, вы получите HTTP-ошибку 400 Bad Request.

Ведра каталогов - Для ведер каталогов поддерживаются только два варианта шифрования на стороне сервера: SSE-S3 и SSE-KMS. SSE-C не поддерживается. Дополнительную информацию см. в разделе Защита данных с помощью шифрования на стороне сервера в руководстве пользователя Amazon S3.

Переопределение значений заголовков ответа через запрос

Иногда требуется переопределить определенные значения заголовков ответа на GetObject. Например, вы можете переопределить значение заголовка ответа Content-Disposition в запросе GetObject.

Можно переопределить значения набора заголовков ответа. Эти изменённые значения заголовков ответа включаются только в успешном ответе, то есть при возвращении HTTP-кода состояния 200 OK. Заголовки, которые можно переопределить, используя параметры запроса, являются подмножеством заголовков, которые Amazon S3 принимает при создании объекта.

Заголовки ответа, которые можно переопределить для GetObject ответа, это Cache-Control , Content-Disposition , Content-Encoding , Content-Language , Content-Type и Expires.

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

response-cache-control
response-content-disposition
response-content-encoding
response-content-language
response-content-type
response-expires

Примечание

При использовании этих параметров запрос необходимо подписать, используя заголовок Authorization или предзагруженный URL. Эти параметры нельзя использовать с незащищенным (анонимным) запросом.

Синтаксис заголовка HTTP Host

Ведра каталогов - Синтаксис заголовка HTTP Host: `` Bucket-name .s3express-zone-id .*region-code* .amazonaws.com`` .

Связанные операции с GetObject:

ListBuckets
GetObjectAcl

См. также: Документация API AWS

Описание

  get-object
--bucket <value>
[--if-match <value>]
[--if-modified-since <value>]
[--if-none-match <value>]
[--if-unmodified-since <value>]
--key <value>
[--range <value>]
[--response-cache-control <value>]
[--response-content-disposition <value>]
[--response-content-encoding <value>]
[--response-content-language <value>]
[--response-content-type <value>]
[--response-expires <value>]
[--version-id <value>]
[--sse-customer-algorithm <value>]
[--sse-customer-key <value>]
[--sse-customer-key-md5 <value>]
[--request-payer <value>]
[--part-number <value>]
[--expected-bucket-owner <value>]
[--checksum-mode <value>]
<outfile>
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--bucket (строка)

Имя ведра, содержащего объект.

Ведра каталогов — при использовании данного действия с ведром каталога необходимо использовать запросы в стиле виртуального хостинга в формате `` Имя-ведра .s3express-идентификатор-зоны .*код-региона* .amazonaws.com`` . Запросы в стиле пути не поддерживаются. Имена ведер каталогов должны быть уникальными в выбранной зоне (зоне доступности или локальной зоне). Имена ведер должны соответствовать формату `` основное-имя-ведра –идентификатор-зоны –x-s3`` (например, `` amzn-s3-demo-bucket –usw2-az1 –x-s3`` ). Сведения о ограничениях именования ведер см. в разделе Правила именования ведер каталогов в руководстве пользователя Amazon S3.

Точки доступа — при использовании данного действия с точкой доступа для ведер общего назначения необходимо указать псевдоним точки доступа вместо имени ведра или указать ARN точки доступа. При использовании данного действия с точкой доступа для ведер каталогов необходимо указать имя точки доступа вместо имени ведра. При использовании ARN точки доступа необходимо направлять запросы на имя хоста точки доступа. Имя хоста точки доступа имеет вид ИмяТочкиДоступа -ИдентификаторАккаунта .s3-accesspoint.*Регион* .amazonaws.com. При использовании данного действия с точкой доступа через Amazon Web Services SDK необходимо указать ARN точки доступа вместо имени ведра. Дополнительные сведения об ARN точек доступа см. в разделе Использование точек доступа в руководстве пользователя Amazon S3.

Точки доступа Object Lambda — при использовании данного действия с точкой доступа Object Lambda необходимо направлять запросы на имя хоста точки доступа Object Lambda. Имя хоста точки доступа Object Lambda имеет вид ИмяТочкиДоступа -ИдентификаторАккаунта .s3-object-lambda.*Регион* .amazonaws.com.

Примечание

Точки доступа Object Lambda не поддерживаются для ведер каталогов.

S3 в Outposts — при использовании данного действия с S3 в Outposts необходимо направлять запросы на имя хоста S3 в Outposts. Имя хоста S3 в Outposts имеет вид `` ИмяТочкиДоступа -ИдентификаторАккаунта .*идентификатор-outpost* .s3-outposts.*Регион* .amazonaws.com`` . При использовании данного действия с S3 в Outposts целевое ведро должно быть ARN точки доступа Outposts или псевдонимом точки доступа. Дополнительные сведения о S3 в Outposts см. в разделе Что такое S3 в Outposts? в руководстве пользователя Amazon S3.

--if-match (строка)

Возвращает объект только в том случае, если его тег сущности (ETag) совпадает с указанным в данном заголовке; в противном случае возвращает ошибку 412 Precondition Failed.

Если в запросе присутствуют оба заголовка If-Match и If-Unmodified-Since следующим образом: условие If-Match вычисляется как true, и; условие If-Unmodified-Since вычисляется как false; тогда S3 возвращает 200 OK и запрашиваемые данные.

Дополнительные сведения о условных запросах см. в RFC 7232.

--if-modified-since (отметка времени)

Возвращает объект только в том случае, если он был изменён после указанного времени; в противном случае возвращает ошибку 304 Not Modified.

Если в запросе присутствуют оба заголовка If-None-Match и If-Modified-Since следующим образом: условие If-None-Match вычисляется как false, и; условие If-Modified-Since вычисляется как true; тогда S3 возвращает код состояния 304 Not Modified.

Дополнительные сведения о условных запросах см. в RFC 7232.

--if-none-match (строка)

Возвращает объект только в том случае, если его тег сущности (ETag) отличается от указанного в данном заголовке; в противном случае возвращает ошибку 304 Not Modified.

Дополнительные сведения о условных запросах см. в RFC 7232.

--if-unmodified-since (отметка времени)

Возвращает объект только в том случае, если он не был изменён после указанного времени; в противном случае возвращает ошибку 412 Precondition Failed.

Дополнительные сведения о условных запросах см. в RFC 7232.

--key (строка)

Ключ объекта для получения.

--range (строка)

Загружает указанный байтовый диапазон объекта. Дополнительные сведения о заголовке HTTP Range см. на https://www.rfc-editor.org/rfc/rfc9110.html#name-range.

Примечание

Amazon S3 не поддерживает получение нескольких диапазонов данных в одном GET запросе.

--response-cache-control (строка)

Устанавливает заголовок Cache-Control ответа.

--response-content-disposition (строка)

Устанавливает заголовок Content-Disposition ответа.

--response-content-encoding (строка)

Устанавливает заголовок Content-Encoding ответа.

--response-content-language (строка)

Устанавливает заголовок Content-Language ответа.

--response-content-type (строка)

Устанавливает заголовок Content-Type ответа.

--response-expires (отметка времени)

Устанавливает заголовок Expires ответа.

--version-id (строка)

Идентификатор версии, используемый для ссылки на определённую версию объекта.

По умолчанию операция GetObject возвращает текущую версию объекта. Для возвращения другой версии используйте подресурс versionId.

Примечание

Если вы включаете versionId в заголовке запроса, у вас должны быть права s3:GetObjectVersion на доступ к определённой версии объекта. Права s3:GetObject в этом случае не требуются.
Если вы запрашиваете текущую версию объекта без указания конкретного versionId в заголовке запроса, требуются только права s3:GetObject. Права s3:GetObjectVersion в этом случае не требуются.
Ведра каталогов — S3 Версионирование не включено и не поддерживается для ведер каталогов. Для данной операции API только значение null идентификатора версии поддерживается ведрами каталогов. Вы можете указать только null для параметра запроса versionId.

Дополнительные сведения о версионировании см. в PutBucketVersioning.

--sse-customer-algorithm (строка)

Указывает алгоритм для расшифровки объекта (например, AES256).

Если вы шифруете объект с использованием серверного шифрования с предоставленными клиентом ключами (SSE-C), храня объект в Amazon S3, то при получении объекта необходимо использовать следующие заголовки:

x-amz-server-side-encryption-customer-algorithm
x-amz-server-side-encryption-customer-key
x-amz-server-side-encryption-customer-key-MD5

Дополнительные сведения о SSE-C см. в разделе Серверное шифрование (использование ключей, предоставленных клиентом) в руководстве пользователя Amazon S3.

Примечание

Данная функциональность не поддерживается для ведер каталогов.

--sse-customer-key (строка)

Указывает предоставленный клиентом ключ шифрования, который вы изначально предоставили Amazon S3 для шифрования данных перед их хранением. Это значение используется для расшифровки объекта при его восстановлении и должно совпадать с используемым при хранении данных. Ключ должен быть подходящим для использования с алгоритмом, указанным в заголовке x-amz-server-side-encryption-customer-algorithm.

x-amz-server-side-encryption-customer-algorithm
x-amz-server-side-encryption-customer-key
x-amz-server-side-encryption-customer-key-MD5

Примечание

Данная функциональность не поддерживается для ведер каталогов.

--sse-customer-key-md5 (строка)

Указывает 128-битный MD5 дайджест предоставленного клиентом ключа шифрования в соответствии с RFC 1321. Amazon S3 использует этот заголовок для проверки целостности сообщения, чтобы убедиться, что ключ шифрования был передан без ошибок.

x-amz-server-side-encryption-customer-algorithm
x-amz-server-side-encryption-customer-key
x-amz-server-side-encryption-customer-key-MD5

Примечание

Данная функциональность не поддерживается для ведер каталогов.

--request-payer (строка)

Подтверждает, что запрашивающий знает, что он будет оплачивать запрос. Владельцам ведер не нужно указывать этот параметр в своих запросах. Если ведро S3 источника или назначения имеет включённую опцию «Оплата запрашивающим», запрашивающий будет оплачивать соответствующие расходы на копирование объекта. Сведения о загрузке объектов из ведер с оплатой запрашивающим см. в разделе Загрузка объектов из ведер с оплатой запрашивающим в руководстве пользователя Amazon S3.

Примечание

Данная функциональность не поддерживается для ведер каталогов.

Возможные значения:

requester

--part-number (целое число)

Номер части объекта, который считывается. Это целое число от 1 до 10 000. Эффективно выполняет запрос GET с диапазоном для указанной части. Полезно для загрузки только части объекта.

--expected-bucket-owner (строка)

Идентификатор учётной записи предполагаемого владельца ведра. Если идентификатор учётной записи, который вы предоставили, не соответствует фактическому владельцу ведра, запрос завершается с HTTP кодом состояния 403 Forbidden (доступ запрещён).

--checksum-mode (строка)

Для получения контрольной суммы этот режим должен быть включён.

Возможные значения:

ENABLED

outfile (строка) Имя файла, в который будет сохранёно содержимое

Глобальные параметры

--debug (boolean)

Включить отладку.

--endpoint-url (string)

Переопределить стандартный URL команды на указанный URL.

--no-verify-ssl (boolean)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI проверяет SSL-сертификаты. Этот параметр переопределяет стандартное поведение проверки SSL-сертификатов.

--no-paginate (boolean)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один запрос для первой страницы результатов.

--output (string)

Стиль форматирования вывода команды.

json
text
table
yaml
yaml-stream

--query (string)

Запрос JMESPath для фильтрации данных ответа.

--profile (string)

Использовать определённый профиль из файла учетных данных.

--region (string)

Используемый регион. Переопределяет настройки из конфигурации/среды.

--version (string)

Отобразить версию инструмента.

--color (string)

Включить/отключить цветной вывод.

включить
выключить
автоматически

--no-sign-request (boolean)

Не подписывать запросы. Учетные данные не будут загружены, если этот параметр указан.

--ca-bundle (string)

Файл сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки из конфигурации/среды.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию — 60 секунд.

--cli-binary-format (string)

Стиль форматирования для двоичных блоков. По умолчанию используется формат base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI версии 1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, отображающего двоичный блок, fileb:// всегда будет обрабатываться как двоичный и использовать содержимое файла непосредственно независимо от настроек cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

base64
raw-in-base64-out

--no-cli-pager (boolean)

Отключить вывод страницы для CLI.

--cli-auto-prompt (boolean)

Автоматически запрашивать параметры ввода CLI.

--no-cli-auto-prompt (boolean)

Отключить автоматическое запросы параметров ввода CLI.

Примеры

Примечание

Чтобы использовать следующие примеры, необходимо установить и настроить AWS CLI. Подробнее см. руководство по началу работы в Руководстве пользователя AWS CLI.

Если не указано иное, все примеры используют правила цитирования Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки терминала. См. раздел Использование кавычек со строками в Руководстве пользователя AWS CLI.

В следующем примере используется команда get-object для скачивания объекта из Amazon S3:

aws s3api get-object --bucket text-content --key dir/my_images.tar.bz2 my_images.tar.bz2

Обратите внимание, что параметр outfile указан без имени опции, такого как «–outfile». Имя выходного файла должно быть последним параметром команды.

В примере ниже показано использование --range для загрузки определенного диапазона байтов из объекта. Обратите внимание, что диапазоны байтов необходимо добавлять с префиксом «bytes=»:

aws s3api get-object --bucket text-content --key dir/my_data --range bytes=8888-9999 my_data_range

Дополнительную информацию о получении объектов см. в Руководстве разработчика Amazon S3.

Вывод

Тело -> (потоковый блок)

Данные объекта.

DeleteMarker -> (булево)

Указывает, был ли извлеченный объект (true) или не был (false) маркером удаления. Если false, эта заголовок ответа не отображается.

Примечание

Если текущая версия объекта является маркером удаления, Amazon S3 ведет себя так, как если бы объект был удален, и включает x-amz-delete-marker: true в ответ.
Если указанная версия в запросе является маркером удаления, ответ возвращает ошибку 405 Method Not Allowed и заголовок ответа Last-Modified: timestamp.

AcceptRanges -> (строка)

Указывает, что в запросе был указан диапазон байтов.

Expiration -> (строка)

Если срок действия объекта настроен (см. ` PutBucketLifecycleConfiguration https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html`__ ), ответ включает этот заголовок. Он содержит пары ключ-значение expiry-date и rule-id, предоставляющие информацию о сроке действия объекта. Значение rule-id закодировано по URL.

Примечание

Информация о сроке действия объекта не возвращается в ведрах каталогов, и этот заголовок возвращает значение “NotImplemented “ во всех ответах для ведер каталогов.

Restore -> (строка)

Предоставляет информацию об действии восстановления объекта и времени истечения срока действия восстановленной копии объекта.

Примечание

Эта функциональность не поддерживается для ведер каталогов. Ведра каталогов поддерживают только EXPRESS_ONEZONE (класс хранения S3 Express One Zone) в зонах доступности и ONEZONE_IA (класс хранения S3 One Zone-Infrequent Access) в выделенных локальных зонах.

LastModified -> (временная метка)

Дата и время последнего изменения объекта.

Ведра общего назначения - При указании versionId объекта в запросе, если указанная версия в запросе является маркером удаления, ответ возвращает ошибку 405 Method Not Allowed и заголовок ответа Last-Modified: timestamp.

ContentLength -> (длинное целое число)

Размер тела в байтах.

ETag -> (строка)

Тег сущности (ETag) — это неявный идентификатор, присваиваемый веб-сервером определенной версии ресурса, найденного по URL.

ChecksumCRC32 -> (строка)

Базовое 64-кодированное 32-битное CRC32 контрольное значение объекта. Это контрольное значение присутствует только в том случае, если объект был загружен с объектом. Дополнительную информацию см. в разделе Проверка целостности объекта в Руководстве пользователя Amazon S3.

ChecksumCRC32C -> (строка)

Базовое 64-кодированное 32-битное CRC32C контрольное значение объекта. Это будет присутствовать только в том случае, если объект был загружен с объектом. Дополнительную информацию см. в разделе Проверка целостности объекта в Руководстве пользователя Amazon S3.

ChecksumCRC64NVME -> (строка)

Базовое 64-кодированное 64-битное CRC64NVME контрольное значение объекта. Дополнительную информацию см. в руководстве пользователя Amazon S3 по проверке целостности объектов.

ChecksumSHA1 -> (строка)

Базовое 64-кодированное 160-битное SHA1 контрольное значение объекта. Это будет присутствовать только в том случае, если объект был загружен с объектом. Дополнительную информацию см. в разделе Проверка целостности объекта в Руководстве пользователя Amazon S3.

ChecksumSHA256 -> (строка)

Базовое 64-кодированное 256-битное SHA256 контрольное значение объекта. Это будет присутствовать только в том случае, если объект был загружен с объектом. Дополнительную информацию см. в разделе Проверка целостности объекта в Руководстве пользователя Amazon S3.

ChecksumType -> (строка)

Тип контрольного значения, определяющий, как контрольные значения частей объединяются, чтобы создать контрольное значение объекта для объектов в нескольких частях. Вы можете использовать этот ответ заголовка, чтобы убедиться, что тип контрольного значения, который получен, совпадает с типом контрольного значения, который был указан в запросе CreateMultipartUpload. Дополнительную информацию см. в разделе Проверка целостности объекта в Руководстве пользователя Amazon S3.

MissingMeta -> (целое число)

Устанавливается в число записей метаданных, не возвращаемых в заголовках, которые начинаются с x-amz-meta-. Это может произойти, если вы создаете метаданные с помощью API, такого как SOAP, который поддерживает более гибкие метаданные, чем REST API. Например, используя SOAP, вы можете создать метаданные, значения которых не являются допустимыми HTTP-заголовками.

Примечание

Эта функциональность не поддерживается для ведер каталогов.

VersionId -> (строка)

Идентификатор версии объекта.

Примечание

Эта функциональность не поддерживается для ведер каталогов.

CacheControl -> (строка)

Указывает поведение кэширования вдоль цепочки запрос/ответ.

ContentDisposition -> (строка)

Указывает информацию о представлении для объекта.

ContentEncoding -> (строка)

Указывает, какие кодировки содержимого были применены к объекту, и, следовательно, какие механизмы декодирования должны быть применены для получения типа носителя, указанного в заголовке Content-Type.

ContentLanguage -> (строка)

Язык содержимого.

ContentRange -> (строка)

Часть объекта, возвращаемая в ответе.

ContentType -> (строка)

Стандартный тип MIME, описывающий формат данных объекта.

Expires -> (временная метка)

Дата и время, после которых объект больше не может кэшироваться.

Примечание

Этот элемент устарел. Используйте ExpiresString вместо него.

ExpiresString -> (строка)

Необработанное значение поля Expires.

WebsiteRedirectLocation -> (строка)

Если ведро настроено как веб-сайт, перенаправляет запросы для этого объекта на другой объект в том же ведре или на внешний URL. Amazon S3 сохраняет значение этого заголовка в метаданных объекта.

Примечание

Эта функциональность не поддерживается для ведер каталогов.

ServerSideEncryption -> (строка)

Алгоритм шифрования на стороне сервера, используемый при хранении этого объекта в Amazon S3.

Metadata -> (карта)

Карта метаданных для хранения с объектом в S3.

ключ -> (строка)

значение -> (строка)

SSECustomerAlgorithm -> (строка)

Если запрошено шифрование на стороне сервера с использованием ключа шифрования, предоставленного клиентом, ответ будет включать этот заголовок для подтверждения используемого алгоритма шифрования.

Примечание

Эта функциональность не поддерживается для ведер каталогов.

SSECustomerKeyMD5 -> (строка)

Если запрошено шифрование на стороне сервера с использованием ключа шифрования, предоставленного клиентом, ответ будет включать этот заголовок, чтобы предоставить проверку целостности сообщения с круговым проходом предоставленного клиентом ключа шифрования.

Примечание

Эта функциональность не поддерживается для ведер каталогов.

SSEKMSKeyId -> (строка)

При наличии указывает идентификатор ключа KMS, который использовался для шифрования объекта.

BucketKeyEnabled -> (булево)

Указывает, использует ли объект ключ ведра S3 для шифрования на стороне сервера с ключами службы управления ключами (KMS) (SSE-KMS).

StorageClass -> (строка)

Предоставляет информацию о классе хранения объекта. Amazon S3 возвращает этот заголовок для всех объектов, кроме объектов класса хранения S3 Standard.

Примечание

RequestCharged -> (строка)

Если присутствует, указывает, что запрос был успешно оплачен.

Примечание

Эта функциональность не поддерживается для ведер каталогов.

ReplicationStatus -> (строка)

Amazon S3 может вернуть это, если ваш запрос связан с ведром, которое является источником или пунктом назначения в правиле репликации.

Примечание

Эта функциональность не поддерживается для ведер каталогов.

PartsCount -> (целое число)

Количество частей, из которых состоит этот объект. Это значение возвращается только в том случае, если вы указали partNumber в своем запросе, и объект был загружен как многочастная загрузка.

TagCount -> (целое число)

Количество тегов, если таковые имеются, на объекте, когда у вас есть соответствующее разрешение на чтение тегов объектов.

Вы можете использовать GetObjectTagging для извлечения набора тегов, связанных с объектом.

Примечание

Эта функциональность не поддерживается для ведер каталогов.

ObjectLockMode -> (строка)

Режим блокировки объекта, который в настоящее время действует для этого объекта.

Примечание

Эта функциональность не поддерживается для ведер каталогов.

ObjectLockRetainUntilDate -> (временная метка)

Дата и время истечения срока действия блокировки объекта для этого объекта.

Примечание

Эта функциональность не поддерживается для ведер каталогов.

ObjectLockLegalHoldStatus -> (строка)

Указывает, есть ли для этого объекта активный юридический удержание. Это поле возвращается только в том случае, если у вас есть разрешение на просмотр статуса юридического удержания объекта.

Примечание

Эта функциональность не поддерживается для ведер каталогов.