get-object-torrent
Описание
Примечание
Данная операция не поддерживается для ведер с каталогами.Возвращает файлы торента из ведра. BitTorrent может сэкономить пропускную способность при распространении больших файлов.
Примечание
Вы можете получить торенты только для объектов размером менее 5 ГБ, которые не зашифрованы с использованием шифрования на стороне сервера с ключом шифрования, предоставленным клиентом.Для использования GET вы должны иметь доступ к чтению объекта.
Данная функциональность не поддерживается для Amazon S3 на Outposts.
Следующее действие связано с GetObjectTorrent :
- GetObject
См. также: AWS API документация
Синтаксис
get-object-torrent
--bucket <value>
--key <value>
[--request-payer <value>]
[--expected-bucket-owner <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 (строка)
--key (строка)
--request-payer (строка)
Подтверждает, что запросчик знает, что будет оплачивать запрос. Владельцам ведер не нужно указывать этот параметр в своих запросах. Если у исходного или целевого S3 ведра включен Requester Pays, запросчик оплатит соответствующие расходы за копирование объекта. Подробнее о загрузке объектов из ведер Requester Pays см. в руководстве пользователя Amazon S3.
Примечание
Данная функциональность не поддерживается для ведер с каталогами.Возможные значения:
requester
--expected-bucket-owner (строка)
403 Forbidden (доступ запрещен).outfile (строка) Имя файла, в который будет сохранёно содержимое.
Глобальные параметры
--debug (логическое значение)
Включить отладочную регистрацию.
--endpoint-url (строка)
Переопределить URL по умолчанию для команды указанным URL.
--no-verify-ssl (логическое значение)
По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение по умолчанию, которое заключается в проверке SSL-сертификатов.
--no-paginate (логическое значение)
Отключить автоматическую постраничность. Если автоматическая постраничность отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (строка)
Стиль форматирования вывода команды.
- json
- text
- table
- yaml
- yaml-stream
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использовать определённый профиль из файла учетных данных.
--region (строка)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (строка)
Показать версию данного инструмента.
--color (строка)
Включить/выключить цветной вывод.
- включено
- выключено
- автоматически
--no-sign-request (логическое значение)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.
--ca-bundle (строка)
Файл с сертификатами CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (целое число)
Максимальное время чтения сокета в секундах. Если значение равно 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.
--cli-connect-timeout (целое число)
Максимальное время подключения сокета в секундах. Если значение равно 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.
--cli-binary-format (строка)
Стиль форматирования для двоичных блоков. По умолчанию используется формат 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 (логическое значение)
Отключить пагинацию командной строки для вывода.
--cli-auto-prompt (логическое значение)
Автоматически запросить параметры командной строки.
--no-cli-auto-prompt (логическое значение)
Отключить автоматическое запрошенние параметров командной строки.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Подробности см. в руководстве по началу работы с AWS CLI.
Если не указано иное, во всех примерах используются правила цитирования Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. Подробности см. в руководстве AWS CLI по использованию кавычек со строками.
Следующая команда создаёт торрент для объекта в ведре с именем amzn-s3-demo-bucket:
aws s3api get-object-torrent --bucket amzn-s3-demo-bucket --key large-video-file.mp4 large-video-file.torrent
Файл торента сохраняется локально в текущей папке. Обратите внимание, что имя выходного файла (large-video-file.torrent) указано без имени опции и должно быть последним аргументом команды.
Вывод
Тело -> (потоковый блок)
RequestCharged -> (строка)
При наличии указывает, что запросчик был успешно обременён оплатой за запрос.
Примечание
Данная функциональность не поддерживается для ведер с каталогами.
© Copyright 2025, Amazon Web Services. Created using Sphinx.