upload-multipart-part

Описание

Данная операция загружает часть архива. Вы можете загружать части архива в любом порядке. Вы также можете загружать их параллельно. Для одного многочастного загрузки вы можете загрузить до 10 000 частей.

Amazon Glacier отклоняет запрос на загрузку части, если выполняется любое из следующих условий:

• Хэш дерева SHA256 не совпадает Чтобы гарантировать, что данные части не повреждены во время передачи, вы вычисляете хэш дерева SHA256 для части и включаете его в свой запрос. При получении данных части Amazon S3 Glacier также вычисляет хэш дерева SHA256. Если эти значения хэшей не совпадают, операция завершается неудачей. Дополнительную информацию о вычислении хэша дерева SHA256 см. в разделе Вычисление контрольных сумм.
• Размер части не совпадает Размер каждой части, кроме последней, должен совпадать с размером, указанным в соответствующем запросе InitiateMultipartUpload. Размер последней части должен быть таким же, как или меньше, чем указанный размер.

• Диапазон не соответствует Значение диапазона байтов в запросе не соответствует размеру части, указанному в соответствующем запросе Initiate. Например, если вы указываете размер части 4194304 байта (4 МБ), то диапазоны 0 до 4194303 байта (4 МБ - 1) и 4194304 (4 МБ) до 8388607 (8 МБ - 1) являются допустимыми диапазонами частей. Однако если вы установите значение диапазона от 2 МБ до 6 МБ, диапазон не будет соответствовать размеру части, и загрузка завершится неудачей.

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

Учётная запись AWS имеет полные разрешения для выполнения всех операций (действий). Однако пользователи AWS Identity and Access Management (IAM) по умолчанию не имеют никаких разрешений. Вам необходимо предоставить им явное разрешение на выполнение определенных действий. Дополнительную информацию см. в разделе Управление доступом с помощью AWS Identity and Access Management (IAM).

Дополнительную справочную информацию и базовый REST API см. в разделах Загрузка больших архивов частями (многочастная загрузка) и Загрузка части в руководстве разработчика Amazon Glacier.

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

Синтаксис

  upload-multipart-part
--account-id <value>
--vault-name <value>
--upload-id <value>
[--checksum <value>]
[--range <value>]
[--body <value>]
[--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]

Параметры

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

--vault-name (строка)

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

--checksum (строка)

--range (строка)

--body (поток)

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

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

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

--debug (логическое значение)

Включить отладочную регистрацию.

--endpoint-url (строка)

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

--no-verify-ssl (логическое значение)

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

--no-paginate (логическое значение)

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

--output (строка)

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

• json
• текст
• таблица
• yaml
• yaml-поток

--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 (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Примеры

Следующая команда загружает первую часть архива размером 1 МБ (1024 x 1024 байта):

aws glacier upload-multipart-part --body part1 --range 'bytes 0-1048575/*' --account-id - --vault-name my-vault --upload-id 19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ

Amazon Glacier требует аргумент идентификатора учётной записи при выполнении операций, но вы можете использовать тире для указания используемой учётной записи.

Параметр тела принимает путь к файлу части на локальной файловой системе. Параметр диапазона принимает диапазон HTTP-контента, указывающий байты, которые занимает часть в завершенном архиве. Идентификатор загрузки возвращается командой aws glacier initiate-multipart-upload и также может быть получен с помощью aws glacier list-multipart-uploads.

Дополнительную информацию о многочастных загрузках в Amazon Glacier с помощью AWS CLI см. в разделе Использование Amazon Glacier в руководстве пользователя AWS CLI.

Вывод

checksum -> (строка)