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 (строка)
--request-token (строка)
WriteGetObjectResponse с запросом конечного пользователя GetObject.--body (потоковый BLOB)
Данные объекта.
Примечание
Этот аргумент имеет тип: потоковый BLOB. Его значение должно быть путем к файлу (например,path/to/file) и не должно начинаться с file:// или fileb://
--status-code (целое число)
Целочисленный код состояния HTTP для соответствующего запроса GetObject. Вот список кодов состояния.
200 - OK206 - Partial Content304 - Not Modified400 - Bad Request401 - Unauthorized403 - Forbidden404 - Not Found405 - Method Not Allowed409 - Conflict411 - Length Required412 - Precondition Failed416 - Range Not Satisfiable500 - Internal Server Error503 - Service Unavailable
--error-code (строка)
GetObject. Не может использоваться с успешным заголовком StatusCode или когда преобразованный объект предоставляется в теле. Все коды ошибок из S3 имеют прописные буквы в начале предложения. Значение регулярного выражения (regex) равно "^[A-Z][a-zA-Z]+$" .--error-message (строка)
GetObject. Не может использоваться с успешным заголовком StatusCode или когда преобразованный объект предоставляется в теле.--accept-ranges (строка)
--cache-control (строка)
--content-disposition (строка)
--content-encoding (строка)
--content-language (строка)
--content-length (длинное целое)
--content-range (строка)
--content-type (строка)
--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 (строка)
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 (булево)
true ) или не является (false ) маркером удаления. Дополнительную информацию о маркерах удаления см. в разделе Работа с маркерами удаления.--e-tag (строка)
--expires (временная метка)
--expiration (строка)
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 см. в разделе Блокировка объектов.
Возможные значения:
GOVERNANCECOMPLIANCE
--object-lock-legal-hold-status (строка)
Указывает, активен ли активный юридический запрет для объекта, хранящегося в Amazon S3.
Возможные значения:
ONOFF
--object-lock-retain-until-date (временная метка)
--parts-count (целое число)
--replication-status (строка)
Если присутствует, указывает, что запрос связан с ведром, которое является источником или местом назначения в правиле репликации. Дополнительную информацию о репликации S3 см. в разделе Репликация.
Возможные значения:
COMPLETEPENDINGFAILEDREPLICACOMPLETED
--request-charged (строка)
Если присутствует, указывает, что запрашивающий успешно оплатил за запрос.
Примечание
Эта функция не поддерживается для ведер каталогов.Возможные значения:
requester
--restore (строка)
--server-side-encryption (строка)
Алгоритм шифрования на стороне сервера, используемый при хранении запрошенного объекта в Amazon S3 (например, AES256, aws:kms).
Возможные значения:
AES256aws:kmsaws:kms:dsse
--sse-customer-algorithm (строка)
--ssekms-key-id (строка)
--sse-customer-key-md5 (строка)
--storage-class (строка)
Предоставляет информацию о классе хранения объекта. Amazon S3 возвращает этот заголовок для всех объектов, кроме объектов класса хранения S3 Standard.
Дополнительную информацию см. в разделе Классы хранения.
Возможные значения:
STANDARDREDUCED_REDUNDANCYSTANDARD_IAONEZONE_IAINTELLIGENT_TIERINGGLACIERDEEP_ARCHIVEOUTPOSTSGLACIER_IRSNOWEXPRESS_ONEZONE
--tag-count (целое число)
--version-id (строка)
--bucket-key-enabled | --no-bucket-key-enabled (boolean)
--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.