create-multipart-upload

Описание

Этот параметр инициирует многочастовую загрузку и возвращает идентификатор загрузки. Этот идентификатор загрузки используется для связывания всех частей в конкретной многочастовой загрузке. Вы указываете этот идентификатор загрузки в каждом последующем запросе загрузки части (см. UploadPart). Вы также включаете этот идентификатор загрузки в окончательный запрос для завершения или прерывания запроса многочастовой загрузки. Дополнительную информацию о многочастовых загрузках см. в разделе Обзор многочастовой загрузки в Руководстве пользователя Amazon S3.

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

Для подписи запроса многочастовая загрузка — это просто ряд обычных запросов. Вы инициируете многочастовую загрузку, отправляете один или несколько запросов на загрузку частей, а затем завершаете процесс многочастовой загрузки. Вы подписываете каждый запрос индивидуально. В подписании запросов многочастовой загрузки нет ничего особенного. Дополнительную информацию о подписании см. в разделе Авторизация запросов (Amazon Web Services Signature Version 4) в Руководстве пользователя Amazon S3.

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

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

  Шифрование

• Ведра общего назначения - Шифрование на стороне сервера предназначено для шифрования данных при хранении. Amazon S3 шифрует ваши данные при записи на диски в своих центрах обработки данных и расшифровывает их при доступе. Amazon S3 автоматически шифрует все новые объекты, загруженные в ведро S3. При выполнении многочастовой загрузки, если вы не указываете информацию о шифровании в своем запросе, параметр шифрования загруженных частей устанавливается в соответствии с параметрами шифрования по умолчанию целевого ведра. По умолчанию все ведра имеют базовый уровень конфигурации шифрования, использующий шифрование на стороне сервера с управляемыми Amazon S3 ключами (SSE-S3). Если в целевом ведре параметр шифрования по умолчанию использует шифрование на стороне сервера с ключом Key Management Service (KMS) (SSE-KMS) или ключом, предоставленным клиентом (SSE-C), Amazon S3 использует соответствующий ключ KMS или предоставленный клиентом ключ для шифрования загруженных частей. При выполнении операции CreateMultipartUpload, если вы хотите использовать другой тип параметра шифрования для загруженных частей, вы можете запросить шифрование объекта Amazon S3 с помощью другого ключа шифрования (например, управляемого Amazon S3 ключа, ключа KMS или ключа, предоставленного клиентом). Когда параметр шифрования в вашем запросе отличается от параметра шифрования по умолчанию целевого ведра, параметр шифрования в вашем запросе имеет приоритет. Если вы решите предоставить свой собственный ключ шифрования, заголовки запроса, которые вы предоставляете в запросах UploadPart и UploadPartCopy, должны совпадать с заголовками, которые вы использовали в запросе CreateMultipartUpload.

  • Используйте ключи KMS (SSE-KMS), которые включают управляемый Amazon Web Services ключ (aws/s3 ) и управляемые клиентом ключи KMS, хранящиеся в Key Management Service (KMS) – Если вы хотите, чтобы Amazon Web Services управлял ключами, используемыми для шифрования данных, укажите следующие заголовки в запросе.
    • x-amz-server-side-encryption
    • x-amz-server-side-encryption-aws-kms-key-id
    • x-amz-server-side-encryption-context

  Примечание

  • Если вы укажите x-amz-server-side-encryption:aws:kms, но не предоставите x-amz-server-side-encryption-aws-kms-key-id, Amazon S3 использует управляемый Amazon Web Services ключ (aws/s3 ключ) в KMS для защиты данных.
  • Чтобы выполнить многочастовую загрузку с шифрованием с использованием ключа Amazon Web Services KMS, запрашивающий должен иметь разрешение на действия kms:Decrypt и kms:GenerateDataKey* на ключе. Эти разрешения необходимы, потому что Amazon S3 должен расшифровать и прочитать данные из зашифрованных частей файла до завершения многочастовой загрузки. Дополнительную информацию см. в разделе API многочастовой загрузки и разрешения и Защита данных с помощью шифрования на стороне сервера с использованием Amazon Web Services KMS в Руководстве пользователя Amazon S3.
  • Если ваш пользователь или роль Identity and Access Management (IAM) находятся в той же учетной записи Amazon Web Services, что и ключ KMS, то вам необходимо иметь эти разрешения в политике ключа. Если ваш пользователь или роль IAM находятся в другой учетной записи, отличной от ключа, то вам необходимо иметь разрешения как в политике ключа, так и в вашей роли или пользователе IAM.
  • Все запросы GET и PUT для объекта, защищенного KMS, завершаются ошибкой, если вы не выполните их с использованием Secure Sockets Layer (SSL), Transport Layer Security (TLS) или Signature Version 4. Сведения о конфигурировании любых поддерживаемых Amazon Web Services SDK и Amazon Web Services CLI см. в разделе Указание версии подписи в авторизации запросов в Руководстве пользователя Amazon S3.

  Дополнительную информацию о шифровании на стороне сервера с использованием ключей KMS (SSE-KMS) см. в разделе Защита данных с помощью шифрования на стороне сервера с использованием ключей KMS в Руководстве пользователя Amazon S3.

  • Используйте ключи шифрования, предоставленные клиентом (SSE-C) – Если вы хотите управлять своими ключами шифрования, предоставьте все следующие заголовки в запросе.
    • x-amz-server-side-encryption-customer-algorithm
    • x-amz-server-side-encryption-customer-key
    • x-amz-server-side-encryption-customer-key-MD5

  Дополнительную информацию о шифровании на стороне сервера с ключами шифрования, предоставленными клиентом (SSE-C), см. в разделе Защита данных с помощью шифрования на стороне сервера с ключами, предоставленными клиентом (SSE-C), в Руководстве пользователя Amazon S3.

• Ведра каталогов - Для ведер каталогов поддерживаются только два варианта шифрования на стороне сервера: шифрование на стороне сервера с управляемыми Amazon S3 ключами (SSE-S3) (AES256 ) и шифрование на стороне сервера с ключами KMS (SSE-KMS) (aws:kms ). Рекомендуется, чтобы параметр шифрования по умолчанию ведра использовал желаемую конфигурацию шифрования, и вы не переопределяли параметр шифрования по умолчанию ведра в ваших запросах CreateSession или запросах объектов PUT. Тогда новые объекты автоматически шифруются с желаемыми параметрами шифрования. Дополнительную информацию см. в разделе Защита данных с помощью шифрования на стороне сервера в Руководстве пользователя Amazon S3. Дополнительную информацию о поведении переопределения шифрования в ведрах каталогов см. в разделе Указание шифрования на стороне сервера с помощью KMS для новых загрузок объектов. В вызовах API зональных конечных точек (кроме CopyObject и UploadPartCopy) с использованием API REST заголовки запроса шифрования должны соответствовать параметрам шифрования, указанным в запросе CreateSession. Нельзя переопределять значения параметров шифрования (x-amz-server-side-encryption , x-amz-server-side-encryption-aws-kms-key-id , x-amz-server-side-encryption-context и x-amz-server-side-encryption-bucket-key-enabled), указанные в запросе CreateSession. Вам не нужно явно указывать эти значения параметров шифрования в вызовах API зональных конечных точек, и Amazon S3 будет использовать значения параметров шифрования из запроса CreateSession для защиты новых объектов в ведре каталога.

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

• UploadPart
• CompleteMultipartUpload
• AbortMultipartUpload
• ListParts
• ListMultipartUploads

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

Резюме

  create-multipart-upload
[--acl <value>]
--bucket <value>
[--cache-control <value>]
[--content-disposition <value>]
[--content-encoding <value>]
[--content-language <value>]
[--content-type <value>]
[--expires <value>]
[--grant-full-control <value>]
[--grant-read <value>]
[--grant-read-acp <value>]
[--grant-write-acp <value>]
--key <value>
[--metadata <value>]
[--server-side-encryption <value>]
[--storage-class <value>]
[--website-redirect-location <value>]
[--sse-customer-algorithm <value>]
[--sse-customer-key <value>]
[--sse-customer-key-md5 <value>]
[--ssekms-key-id <value>]
[--ssekms-encryption-context <value>]
[--bucket-key-enabled | --no-bucket-key-enabled]
[--request-payer <value>]
[--tagging <value>]
[--object-lock-mode <value>]
[--object-lock-retain-until-date <value>]
[--object-lock-legal-hold-status <value>]
[--expected-bucket-owner <value>]
[--checksum-algorithm <value>]
[--checksum-type <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]

Параметры

--acl (строка)

--bucket (строка)

--cache-control (строка)

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

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

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

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

--expires (метка времени)

--grant-full-control (строка)

--grant-read (строка)

--grant-read-acp (строка)

--grant-write-acp (строка)

--key (строка)

--metadata (карта)

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

KeyName1=string,KeyName2=string

Синтаксис JSON:

{"string": "string"
  ...}

--server-side-encryption (строка)

--storage-class (строка)

--website-redirect-location (строка)

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

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

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

--ssekms-key-id (строка)

--ssekms-encryption-context (строка)

--bucket-key-enabled | --no-bucket-key-enabled (булево)

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

--tagging (строка)

--object-lock-mode (строка)

--object-lock-retain-until-date (отметка времени)

--object-lock-legal-hold-status (строка)

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

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

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

--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
• text
• table
• yaml
• yaml-stream

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определенный профиль из вашего файла учетных данных.

--region (строка)

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

--version (строка)

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

--color (строка)

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

• on
• off
• auto

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

Примеры

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

aws s3api create-multipart-upload --bucket amzn-s3-demo-bucket --key 'multipart/01'

Вывод:

{
    "Bucket": "amzn-s3-demo-bucket",
    "UploadId": "dfRtDYU0WWCCcH43C3WFbkRONycyCpTJJvxu2i5GYkZljF.Yxwh6XG7WfS2vC4to6HiV6Yjlx.cph0gtNBtJ8P3URCSbB7rjxI5iEwVDmgaXZOGgkk5nVTW16HOQ5l0R",
    "Key": "multipart/01"
}

Завершенный файл будет назван 01 в папке под названием multipart в ведре amzn-s3-demo-bucket. Сохраните ID загрузки, ключ и имя ведра для использования с командой upload-part.

Вывод

AbortDate -> (отметка времени)

AbortRuleId -> (строка)

Bucket -> (строка)

Key -> (строка)

UploadId -> (строка)

ServerSideEncryption -> (строка)

SSECustomerAlgorithm -> (строка)

SSECustomerKeyMD5 -> (строка)

SSEKMSKeyId -> (строка)

SSEKMSEncryptionContext -> (строка)

BucketKeyEnabled -> (булево)

RequestCharged -> (строка)

ChecksumAlgorithm -> (строка)

ChecksumType -> (строка)