complete-multipart-upload

Описание

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

Сначала необходимо инициировать многочастную загрузку, а затем загрузить все части с помощью операции UploadPart или UploadPartCopy. После успешной загрузки всех необходимых частей загрузки вызывается эта CompleteMultipartUpload операция для завершения загрузки. При получении этого запроса Amazon S3 конкатенирует все части в порядке возрастания номера части, чтобы создать новый объект. В запросе CompleteMultipartUpload необходимо предоставить список частей и убедиться, что список частей является полным. Операция API CompleteMultipartUpload конкатенирует части, которые вы предоставляете в списке. Для каждой части в списке необходимо предоставить значение PartNumber и значение ETag, которые возвращаются после загрузки этой части.

Обработка запроса CompleteMultipartUpload может занять несколько минут. После того, как Amazon S3 начнёт обработку запроса, он отправляет заголовок HTTP ответа, который указывает на 200 OK ответ. Пока обработка продолжается, Amazon S3 периодически отправляет пробельные символы, чтобы предотвратить таймаут соединения. Запрос может завершиться ошибкой после отправки начального 200 OK ответа. Это означает, что 200 OK ответ может содержать либо успешное завершение, либо ошибку. Ответ с ошибкой может быть вложен в 200 OK ответ. Если вы вызываете эту операцию API напрямую, убедитесь, что ваше приложение разработано для обработки содержимого ответа и соответствующей обработки. Если вы используете Amazon Web Services SDK, SDK обрабатывают эту ситуацию. SDK обнаруживают встроенную ошибку и применяют обработку ошибок в соответствии с вашими настройками (включая автоматическое повторное выполнение запроса, если это необходимо). Если проблема сохраняется, SDK выбрасывает исключение (или, для SDK, которые не используют исключения, они возвращают ошибку).

Обратите внимание, что если CompleteMultipartUpload завершается ошибкой, приложения должны быть готовы повторно выполнить любые неудачные запросы (включая ответы с кодом ошибки 500). Для получения дополнительной информации см. Лучшие практики обработки ошибок Amazon S3 .

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

• Разрешения для ведерок общего назначения - для получения информации о разрешениях, необходимых для использования API многочастной загрузки, см. Многочастная загрузка и разрешения в Руководстве пользователя Amazon S3 . Если вы предоставляете дополнительное значение контрольной суммы в своих запросах MultipartUpload, а объект зашифрован с помощью Key Management Service, вам необходимо иметь разрешение на использование действия kms:Decrypt для запроса CompleteMultipartUpload, чтобы он был успешным.

• Разрешения для ведерок каталогов - для предоставления доступа к этой операции API для ведерка каталогов рекомендуется использовать операцию 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.

  Специальные ошибки

• Код ошибки: EntityTooSmall

  • Описание: Предлагаемая загрузка меньше минимально разрешённого размера объекта. Каждая часть должна иметь размер не менее 5 МБ, за исключением последней части.
  • Код состояния HTTP: 400 Bad Request

• Код ошибки: InvalidPart

  • Описание: Одна или несколько указанных частей не были найдены. Возможно, часть не была загружена или указанный ETag не совпадал с ETag загруженной части.
  • Код состояния HTTP: 400 Bad Request

• Код ошибки: InvalidPartOrder

  • Описание: Список частей был не в порядке возрастания. Список частей должен быть указан в порядке возрастания номера части.
  • Код состояния HTTP: 400 Bad Request

• Код ошибки: NoSuchUpload

  • Описание: Указанная многочастная загрузка не существует. Идентификатор загрузки может быть неверным или многочастная загрузка может быть прервана или завершена.
  • Код состояния HTTP: 404 Not Found

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

Следующие операции связаны с CompleteMultipartUpload :

• CreateMultipartUpload
• UploadPart
• AbortMultipartUpload
• ListParts
• ListMultipartUploads

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

Синтаксис

  complete-multipart-upload
--bucket <value>
--key <value>
[--multipart-upload <value>]
--upload-id <value>
[--checksum-crc32 <value>]
[--checksum-crc32-c <value>]
[--checksum-crc64-nvme <value>]
[--checksum-sha1 <value>]
[--checksum-sha256 <value>]
[--checksum-type <value>]
[--mpu-object-size <value>]
[--request-payer <value>]
[--expected-bucket-owner <value>]
[--if-match <value>]
[--if-none-match <value>]
[--sse-customer-algorithm <value>]
[--sse-customer-key <value>]
[--sse-customer-key-md5 <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]

Параметры

--bucket (строка)

--key (строка)

--multipart-upload (структура)

Краткая синтаксическая запись:

Parts=[{ETag=string,ChecksumCRC32=string,ChecksumCRC32C=string,ChecksumCRC64NVME=string,ChecksumSHA1=string,ChecksumSHA256=string,PartNumber=integer},{ETag=string,ChecksumCRC32=string,ChecksumCRC32C=string,ChecksumCRC64NVME=string,ChecksumSHA1=string,ChecksumSHA256=string,PartNumber=integer}]

Синтаксис JSON:

{
  "Parts": [
    {
      "ETag": "string",
      "ChecksumCRC32": "string",
      "ChecksumCRC32C": "string",
      "ChecksumCRC64NVME": "string",
      "ChecksumSHA1": "string",
      "ChecksumSHA256": "string",
      "PartNumber": integer
    }
    ...
  ]
}

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

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

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

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

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

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

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

--mpu-object-size (длинное целое)

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

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

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

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

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

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

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

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

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

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

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

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

Примеры

Следующая команда завершает многочастотный загрузку для ключа multipart/01 в ведре amzn-s3-demo-bucket:

aws s3api complete-multipart-upload --multipart-upload file://mpustruct --bucket amzn-s3-demo-bucket --key 'multipart/01' --upload-id dfRtDYU0WWCCcH43C3WFbkRONycyCpTJJvxu2i5GYkZljF.Yxwh6XG7WfS2vC4to6HiV6Yjlx.cph0gtNBtJ8P3URCSbB7rjxI5iEwVDmgaXZOGgkk5nVTW16HOQ5l0R

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

Параметр многочастотной загрузки в вышеприведенной команде принимает JSON-структуру, описывающую части многочастотной загрузки, которые должны быть объединены в один полный файл. В этом примере используется префикс file:// для загрузки JSON-структуры из файла в локальной папке с именем mpustruct.

mpustruct:

{
  "Parts": [
    {
      "ETag": "e868e0f4719e394144ef36531ee6824c",
      "PartNumber": 1
    },
    {
      "ETag": "6bb2b12753d66fe86da4998aa33fffb0",
      "PartNumber": 2
    },
    {
      "ETag": "d0a0112e841abec9c9ec83406f0159c8",
      "PartNumber": 3
    }
  ]
}

Значение ETag для каждой части загрузки выводится каждый раз, когда вы загружаете часть с помощью команды upload-part, и также может быть получено, вызвав list-parts, или рассчитано, взяв контрольную сумму MD5 каждой части.

Вывод:

{
    "ETag": "\"3944a9f7a4faab7f78788ff6210f63f0-3\"",
    "Bucket": "amzn-s3-demo-bucket",
    "Location": "https://amzn-s3-demo-bucket.s3.amazonaws.com/multipart%2F01",
    "Key": "multipart/01"
}

Вывод

Расположение -> (строка)

Ведро -> (строка)

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

Срок действия -> (строка)

ETag -> (строка)

ChecksumCRC32 -> (строка)

ChecksumCRC32C -> (строка)

ChecksumCRC64NVME -> (строка)

ChecksumSHA1 -> (строка)

ChecksumSHA256 -> (строка)

ChecksumType -> (строка)

ServerSideEncryption -> (строка)

VersionId -> (строка)

SSEKMSKeyId -> (строка)

BucketKeyEnabled -> (булево)

RequestCharged -> (строка)