Spec-Zone.ru › AWS CLI v2

[ aws . s3api ]

write-get-object-response

Описание

Примечание

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

Передает преобразованные объекты в операцию GetObject при использовании точек доступа Object Lambda. Сведения о точках доступа Object Lambda см. в разделе Преобразование объектов с помощью точек доступа Object Lambda в Руководстве пользователя Amazon S3.

Данная операция поддерживает метаданные, которые могут быть возвращены операцией GetObject, а также RequestRoute, RequestToken, StatusCode, ErrorCode и ErrorMessage. Поддерживаются метаданные ответа GetObject, чтобы вызывающий элемент WriteGetObjectResponse, обычно функция Lambda, мог предоставить те же метаданные при внутреннем вызове GetObject. Если WriteGetObjectResponse вызывается функцией Lambda, принадлежащей клиенту, метаданные, возвращаемые конечному пользователю в вызове GetObject, могут отличаться от тех, которые обычно возвращает Amazon S3.

Можно включить любое количество заголовков метаданных. Заголовок метаданных должен предваряться x-amz-meta. Например, x-amz-meta-my-custom-header: MyCustomValue. Основной случай использования — передача метаданных GetObject.

Amazon Web Services предоставляет некоторые предварительно созданные функции Lambda, которые можно использовать с S3 Object Lambda для обнаружения и удаления личностно идентифицируемой информации (PII) и распаковки объектов S3. Эти функции Lambda доступны в репозитории приложений Amazon Web Services Serverless и могут быть выбраны в консоли управления Amazon Web Services при создании точки доступа Object Lambda.

Пример 1: Управление доступом к PII — эта функция Lambda использует Amazon Comprehend, службу обработки естественного языка (NLP), использующую машинное обучение для поиска информации и связей в тексте. Она автоматически обнаруживает личностно идентифицируемую информацию (PII), такую как имена, адреса, даты, номера кредитных карт и номера социального страхования из документов в вашем ведре Amazon S3.

Пример 2: Удаление PII — эта функция Lambda использует Amazon Comprehend, службу обработки естественного языка (NLP), использующую машинное обучение для поиска информации и связей в тексте. Она автоматически удаляет личностно идентифицируемую информацию (PII), такую как имена, адреса, даты, номера кредитных карт и номера социального страхования из документов в вашем ведре Amazon S3.

Пример 3: Распаковка — функция Lambda S3ObjectLambdaDecompression предназначена для распаковки объектов, хранящихся в S3, в одном из шести сжатых форматов файлов, включая bzip2, gzip, snappy, zlib, zstandard и ZIP.

Сведения о том, как просмотреть и использовать эти функции, см. в разделе Использование встроенных функций Lambda Amazon Web Services в Руководстве пользователя Amazon S3.

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

Резюме

  write-get-object-response
--request-route <value>
--request-token <value>
[--body <value>]
[--status-code <value>]
[--error-code <value>]
[--error-message <value>]
[--accept-ranges <value>]
[--cache-control <value>]
[--content-disposition <value>]
[--content-encoding <value>]
[--content-language <value>]
[--content-length <value>]
[--content-range <value>]
[--content-type <value>]
[--checksum-crc32 <value>]
[--checksum-crc32-c <value>]
[--checksum-crc64-nvme <value>]
[--checksum-sha1 <value>]
[--checksum-sha256 <value>]
[--delete-marker | --no-delete-marker]
[--e-tag <value>]
[--expires <value>]
[--expiration <value>]
[--last-modified <value>]
[--missing-meta <value>]
[--metadata <value>]
[--object-lock-mode <value>]
[--object-lock-legal-hold-status <value>]
[--object-lock-retain-until-date <value>]
[--parts-count <value>]
[--replication-status <value>]
[--request-charged <value>]
[--restore <value>]
[--server-side-encryption <value>]
[--sse-customer-algorithm <value>]
[--ssekms-key-id <value>]
[--sse-customer-key-md5 <value>]
[--storage-class <value>]
[--tag-count <value>]
[--version-id <value>]
[--bucket-key-enabled | --no-bucket-key-enabled]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--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]

Параметры

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

Префикс маршрута к генерируемому HTTP-URL.

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

Зашифрованный токен одноразового использования, который сопоставляет WriteGetObjectResponse с запросом конечного пользователя GetObject.

--body (потоковый BLOB)

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

Примечание

Этот аргумент имеет тип: потоковый BLOB. Его значение должно быть путем к файлу (например, path/to/file) и не должно начинаться с file:// или fileb://

--status-code (целое число)

Целочисленный код состояния HTTP для соответствующего запроса GetObject. Вот список кодов состояния.

  • 200 - OK
  • 206 - Partial Content
  • 304 - Not Modified
  • 400 - Bad Request
  • 401 - Unauthorized
  • 403 - Forbidden
  • 404 - Not Found
  • 405 - Method Not Allowed
  • 409 - Conflict
  • 411 - Length Required
  • 412 - Precondition Failed
  • 416 - Range Not Satisfiable
  • 500 - Internal Server Error
  • 503 - Service Unavailable

--error-code (строка)

Строка, которая уникально идентифицирует состояние ошибки. Возвращается в теге <Code> XML-ответа об ошибке для соответствующего вызова GetObject. Не может использоваться с успешным заголовком StatusCode или когда преобразованный объект предоставляется в теле. Все коды ошибок из S3 имеют прописные буквы в начале предложения. Значение регулярного выражения (regex) равно "^[A-Z][a-zA-Z]+$" .

--error-message (строка)

Содержит общее описание состояния ошибки. Возвращается в теге <Message> XML-ответа об ошибке для соответствующего вызова GetObject. Не может использоваться с успешным заголовком StatusCode или когда преобразованный объект предоставляется в теле.

--accept-ranges (строка)

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

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

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

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

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

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

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

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

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

--content-length (длинное целое)

Размер тела содержимого в байтах.

--content-range (строка)

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

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

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

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

Этот заголовок можно использовать для проверки целостности данных, чтобы убедиться, что полученные данные совпадают с исходными данными. Он указывает Base64-кодированную, 32-битную CRC32 контрольную сумму объекта, возвращенного функцией Object Lambda. Она может не совпадать с контрольной суммой объекта, хранящегося в Amazon S3. Amazon S3 будет выполнять проверку значений контрольных сумм только в том случае, если исходный запрос GetObject требовал проверки контрольной суммы. Дополнительную информацию о контрольных суммах см. в разделе Проверка целостности объектов в Руководстве пользователя Amazon S3.

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

--checksum-crc32-c (строка)

Этот заголовок можно использовать для проверки целостности данных, чтобы убедиться, что полученные данные совпадают с исходными данными. Он указывает Base64-кодированную, 32-битную CRC32C контрольную сумму объекта, возвращенного функцией Object Lambda. Она может не совпадать с контрольной суммой объекта, хранящегося в Amazon S3. Amazon S3 будет выполнять проверку значений контрольных сумм только в том случае, если исходный запрос GetObject требовал проверки контрольной суммы. Дополнительную информацию о контрольных суммах см. в разделе Проверка целостности объектов в Руководстве пользователя Amazon S3.

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

--checksum-crc64-nvme (строка)

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

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

Этот заголовок можно использовать для проверки целостности данных, чтобы убедиться, что полученные данные совпадают с исходными данными. Он указывает Base64-кодированный, 160-битный SHA1 дайджест объекта, возвращенного функцией Object Lambda. Он может не совпадать с контрольной суммой объекта, хранящегося в Amazon S3. Amazon S3 будет выполнять проверку значений контрольных сумм только в том случае, если исходный запрос GetObject требовал проверки контрольной суммы. Дополнительную информацию о контрольных суммах см. в разделе Проверка целостности объектов в Руководстве пользователя Amazon S3.

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

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

Этот заголовок можно использовать для проверки целостности данных, чтобы убедиться, что полученные данные совпадают с исходными данными. Он указывает Base64-кодированный, 256-битный SHA256 дайджест объекта, возвращенного функцией Object Lambda. Он может не совпадать с контрольной суммой объекта, хранящегося в Amazon S3. Amazon S3 будет выполнять проверку значений контрольных сумм только в том случае, если исходный запрос GetObject требовал проверки контрольной суммы. Дополнительную информацию о контрольных суммах см. в разделе Проверка целостности объектов в Руководстве пользователя Amazon S3.

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

--delete-marker | --no-delete-marker (булево)

Указывает, является ли объект, хранящийся в Amazon S3, (true ) или не является (false ) маркером удаления. Дополнительную информацию о маркерах удаления см. в разделе Работа с маркерами удаления.

--e-tag (строка)

Непрозрачный идентификатор, присвоенный веб-сервером определенной версии ресурса, найденного по URL.

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

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

--expiration (строка)

Если истечение срока действия объекта настроено (см. PUT Bucket lifecycle), ответ включает этот заголовок. Он содержит пары ключ-значение expiry-date и rule-id, которые предоставляют информацию об истечении срока действия объекта. Значение rule-id закодировано по URL.

--last-modified (временная метка)

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

--missing-meta (целое число)

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

--metadata (карта)

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

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

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

Краткая синтаксическая конструкция:

KeyName1=string,KeyName2=string

Синтаксис JSON:

{"string": "string"
  ...}

--object-lock-mode (строка)

Указывает, включена ли блокировка объектов для объекта, хранящегося в Amazon S3. Дополнительную информацию о блокировке объектов S3 см. в разделе Блокировка объектов.

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

  • GOVERNANCE
  • COMPLIANCE

--object-lock-legal-hold-status (строка)

Указывает, активен ли активный юридический запрет для объекта, хранящегося в Amazon S3.

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

  • ON
  • OFF

--object-lock-retain-until-date (временная метка)

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

--parts-count (целое число)

Количество частей у этого объекта.

--replication-status (строка)

Если присутствует, указывает, что запрос связан с ведром, которое является источником или местом назначения в правиле репликации. Дополнительную информацию о репликации S3 см. в разделе Репликация.

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

  • COMPLETE
  • PENDING
  • FAILED
  • REPLICA
  • COMPLETED

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

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

Примечание

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

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

  • requester

--restore (строка)

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

--server-side-encryption (строка)

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

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

  • AES256
  • aws:kms
  • aws:kms:dsse

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

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

--ssekms-key-id (строка)

Если присутствует, указывает идентификатор (ID ключа, ARN ключа или псевдоним ключа) управляемого клиентом симметричного ключа шифрования Amazon Web Services Key Management Service (Amazon Web Services KMS), который использовался для хранения объекта в Amazon S3.

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

128-битный дайджест MD5 предоставленного клиентом ключа шифрования, используемого в Amazon S3 для шифрования данных, хранящихся в S3. Дополнительную информацию см. в разделе Защита данных с помощью шифрования на стороне сервера с предоставленным пользователем ключом шифрования (SSE-C).

--storage-class (строка)

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

Дополнительную информацию см. в разделе Классы хранения.

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

  • STANDARD
  • REDUCED_REDUNDANCY
  • STANDARD_IA
  • ONEZONE_IA
  • INTELLIGENT_TIERING
  • GLACIER
  • DEEP_ARCHIVE
  • OUTPOSTS
  • GLACIER_IR
  • SNOW
  • EXPRESS_ONEZONE

--tag-count (целое число)

Количество тегов, если они есть, на объекте.

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

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

--bucket-key-enabled | --no-bucket-key-enabled (boolean)

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

--cli-input-json | --cli-input-yaml (string) Считывает аргументы из предоставленной JSON-строки. JSON-строка следует формату, предоставленному --generate-cli-skeleton. Если другие аргументы предоставлены в командной строке, эти значения переопределят значения, предоставленные JSON. Невозможно передавать произвольные двоичные значения с помощью предоставленного JSON-значения, поскольку строка будет взята буквально. Это может не быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (string) Выводит JSON-скелет в стандартный вывод без отправки запроса API. Если предоставлено без значения или значение input, выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если предоставлено yaml-input, он выведет пример входного YAML, который можно использовать с --cli-input-yaml. Если предоставлено значение output, он проверит входные данные команды и вернет пример выходного JSON для этой команды. Сгенерированный JSON-скелет нестабилен между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

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

--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)

Регион для использования. Переопределяет настройки config/env.

--version (string)

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

--color (string)

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

  • on
  • off
  • auto

--no-sign-request (boolean)

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

--ca-bundle (string)

Файл сертификатов CA для использования при проверке сертификатов SSL. Переопределяет настройки config/env.

--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 V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, которое соответствует двоичному блоку, 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.

Вывод

Нет

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API