upload-part

Описание

Загружает часть в многочастотной загрузке.

Вы должны инициировать многочастотную загрузку (см. CreateMultipartUpload ) прежде чем вы сможете загрузить любую часть. В ответ на ваш запрос инициализации Amazon S3 возвращает идентификатор загрузки, уникальный идентификатор, который вы должны включить в ваш запрос загрузки части.

Номера частей могут быть любым числом от 1 до 10 000 включительно. Номер части уникально идентифицирует часть и также определяет её позицию в объекте, который создается. Если вы загружаете новую часть, используя тот же номер части, что использовался с предыдущей частью, то предыдущая загруженная часть перезаписывается.

Сведения о максимальных и минимальных размерах частей и других спецификациях многочастотной загрузки см. в разделе Пределы многочастотной загрузки в Руководстве пользователя Amazon S3 .

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

• Разрешения ведер общего назначения - Для выполнения многочастотной загрузки с шифрованием с использованием ключа службы управления ключами запрашивающий должен иметь разрешение на kms:Decrypt и kms:GenerateDataKey действия над ключом. Запрашивающий также должен иметь разрешения на kms:GenerateDataKey действие для CreateMultipartUpload API. Затем запрашивающий нуждается в разрешениях на kms:Decrypt действие над UploadPart и UploadPartCopy API. Эти разрешения необходимы, потому что Amazon S3 должен расшифровать и прочитать данные из зашифрованных частей файла, прежде чем завершит многочастотную загрузку. Дополнительную информацию о разрешениях KMS см. в разделе Защита данных с помощью шифрования на стороне сервера с использованием KMS в Руководстве пользователя Amazon S3 . Сведения о разрешениях, необходимых для использования API многочастотной загрузки, см. в разделе Многочастотная загрузка и разрешения и API многочастотной загрузки и разрешения в Руководстве пользователя Amazon S3 .

• Разрешения ведерных каталогов - Для предоставления доступа к этой 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.

  Целостность данных

• Ведро общего назначения - Шифрование на стороне сервера предназначено для шифрования данных при хранении. Amazon S3 шифрует ваши данные при записи на диски в своих центрах обработки данных и расшифровывает их при доступе к ним. У вас есть взаимоисключающие варианты защиты данных с помощью шифрования на стороне сервера в Amazon S3, в зависимости от того, как вы выберете управление ключами шифрования. В частности, вариантами ключей шифрования являются ключи Amazon S3 (SSE-S3), ключи Amazon Web Services KMS (SSE-KMS) и ключи, предоставленные клиентом (SSE-C). Amazon S3 шифрует данные с помощью управляемых Amazon S3 ключей (SSE-S3) по умолчанию. Вы можете указать Amazon S3 на шифрование данных при хранении с использованием других вариантов ключей шифрования. Выбор зависит от того, хотите ли вы использовать ключи KMS (SSE-KMS) или предоставить свой собственный ключ шифрования (SSE-C). Шифрование на стороне сервера поддерживается операциями S3 многочастотной загрузки. Если вы не используете ключ шифрования, предоставленный клиентом (SSE-C), вам не нужно указывать параметры шифрования в каждом запросе UploadPart. Вместо этого вам нужно указать параметры шифрования на стороне сервера только в начальном запросе Initiate Multipart. Дополнительная информация приведена в разделе CreateMultipartUpload . Если вы запросите шифрование на стороне сервера с помощью ключа, предоставленного клиентом (SSE-C), в своем запросе инициализации многочастотной загрузки, вы должны предоставить идентичную информацию о шифровании в каждой загрузке части, используя следующие заголовки запроса.
  • x-amz-server-side-encryption-customer-algorithm
  • x-amz-server-side-encryption-customer-key
  • x-amz-server-side-encryption-customer-key-MD5

Дополнительную информацию см. в разделе Использование шифрования на стороне сервера в Руководстве пользователя Amazon S3 .

• Ведерные каталоги - Для ведерных каталогов поддерживаются только два варианта шифрования на стороне сервера: шифрование на стороне сервера с управляемыми ключами Amazon S3 (SSE-S3) (AES256 ) и шифрование на стороне сервера с ключами KMS (SSE-KMS) (aws:kms ).

  Особые ошибки

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

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

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

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

• CreateMultipartUpload
• CompleteMultipartUpload
• AbortMultipartUpload
• ListParts
• ListMultipartUploads

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

Краткое описание

  upload-part
[--body <value>]
--bucket <value>
[--content-length <value>]
[--content-md5 <value>]
[--checksum-algorithm <value>]
[--checksum-crc32 <value>]
[--checksum-crc32-c <value>]
[--checksum-crc64-nvme <value>]
[--checksum-sha1 <value>]
[--checksum-sha256 <value>]
--key <value>
--part-number <value>
--upload-id <value>
[--sse-customer-algorithm <value>]
[--sse-customer-key <value>]
[--sse-customer-key-md5 <value>]
[--request-payer <value>]
[--expected-bucket-owner <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]

Параметры

--body (потоковый блок)

--bucket (строка)

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

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

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

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

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

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

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

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

--key (строка)

--part-number (целое число)

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

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

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

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

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

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

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

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (string)

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

--color (string)

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

• on
• off
• auto

--no-sign-request (boolean)

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

--ca-bundle (string)

Файл с набором CA-сертификатов для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.

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

Примеры

Следующая команда загружает первую часть в многочастотной загрузке, инициированной командой create-multipart-upload:

aws s3api upload-part --bucket amzn-s3-demo-bucket --key 'multipart/01' --part-number 1 --body part01 --upload-id  "dfRtDYU0WWCCcH43C3WFbkRONycyCpTJJvxu2i5GYkZljF.Yxwh6XG7WfS2vC4to6HiV6Yjlx.cph0gtNBtJ8P3URCSbB7rjxI5iEwVDmgaXZOGgkk5nVTW16HOQ5l0R"

Параметр body принимает имя или путь к локальному файлу для загрузки (не используйте префикс file://). Минимальный размер части составляет 5 МБ. Идентификатор загрузки возвращается командой create-multipart-upload и также может быть получен с помощью команды list-multipart-uploads. Ведро и ключ задаются при создании многочастотной загрузки.

Вывод:

{
    "ETag": "\"e868e0f4719e394144ef36531ee6824c\""
}

Сохраните значение ETag каждой части для последующего использования. Они необходимы для завершения многочастотной загрузки.

Вывод

ServerSideEncryption -> (string)

ETag -> (string)

ChecksumCRC32 -> (string)

ChecksumCRC32C -> (string)

ChecksumCRC64NVME -> (string)

ChecksumSHA1 -> (string)

ChecksumSHA256 -> (string)

SSECustomerAlgorithm -> (string)

SSECustomerKeyMD5 -> (string)

SSEKMSKeyId -> (string)

BucketKeyEnabled -> (boolean)

RequestCharged -> (string)