upload-part-copy

Описание

Загружает часть объекта, копируя данные из существующего объекта в качестве источника данных. Для указания источника данных добавьте заголовок запроса x-amz-copy-source в свой запрос. Для указания диапазона байтов добавьте заголовок запроса x-amz-copy-source-range в свой запрос.

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

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

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

Все UploadPartCopy запросы должны быть аутентифицированы и подписаны с использованием учетных данных IAM (идентификатор ключа доступа и секретный ключ доступа для идентификаторов IAM). Все заголовки с префиксом x-amz-, включая x-amz-copy-source, должны быть подписаны. Дополнительную информацию см. в разделе REST Аутентификация.

Amazon Web Services CLI или SDKs обрабатывают аутентификацию и авторизацию от вашего имени.

Необходимо иметь READ доступ к исходному объекту и WRITE доступ к ведру назначения.

• Разрешения на ведра общего назначения — Необходимо иметь разрешения в политике, основанные на типах ведер исходного и целевого ведра в UploadPartCopy операции.
  • Если исходный объект находится в ведре общего назначения, необходимо иметь разрешение ** s3:GetObject ** для чтения исходного объекта, который копируется.
  • Если целевое ведро является ведром общего назначения, необходимо иметь разрешение ** s3:PutObject ** для записи копии объекта в целевое ведро.
  • Для выполнения многочастной загрузки с шифрованием с использованием ключа службы управления ключами запрашивающему необходимо разрешение на kms:Decrypt и kms:GenerateDataKey действия по ключу. Запрашивающий также должен иметь разрешения на kms:GenerateDataKey действие для CreateMultipartUpload API. Затем запрашивающему нужны разрешения на kms:Decrypt действие на UploadPart и UploadPartCopy API. Эти разрешения необходимы, потому что Amazon S3 должен расшифровать и прочитать данные из зашифрованных частей файла, прежде чем завершить многочастную загрузку. Дополнительную информацию о разрешениях KMS см. в разделе Защита данных с помощью шифрования на сервере с помощью KMS в Руководстве пользователя Amazon S3. Сведения о разрешениях, необходимых для использования API многочастной загрузки, см. в разделах Многочастная загрузка и разрешения и API многочастной загрузки и разрешения в Руководстве пользователя Amazon S3.
• Разрешения на ведерные каталоги — Необходимо иметь разрешения в политике ведра или политике, основанной на идентификаторе IAM, на основе типов исходного и целевого ведра в UploadPartCopy операции.
  • Если исходный объект, который вы хотите скопировать, находится в ведре каталога, необходимо иметь разрешение ** s3express:CreateSession ** в элементе Action политики для чтения объекта. По умолчанию сессия находится в режиме ReadWrite. Если вы хотите ограничить доступ, вы можете явно установить ключ условия s3express:SessionMode на ReadOnly в ведре-источнике копии.
  • Если целевой объект является ведром каталога, необходимо иметь разрешение ** s3express:CreateSession ** в элементе Action политики для записи объекта в целевое ведро. Ключ условия s3express:SessionMode не может быть установлен на ReadOnly в ведре-назначении копии.

Если объект зашифрован с помощью SSE-KMS, необходимо также иметь разрешения kms:GenerateDataKey и kms:Decrypt в политиках, основанных на идентификаторах IAM, и политиках ключа KMS для ключа KMS.

Примеры политик см. в разделах Примеры политик ведра для S3 Express One Zone и Политики идентификаторов Amazon Web Services Identity and Access Management (IAM) для S3 Express One Zone в Руководстве пользователя Amazon S3.

• Ведра общего назначения — Сведения об использовании шифрования на сервере с ключами шифрования, предоставленными клиентом, с помощью UploadPartCopy операции см. в разделах CopyObject и UploadPart.
• Ведерные каталоги — Для ведерных каталогов поддерживаются только два варианта шифрования на сервере: шифрование на сервере с ключами Amazon S3 (SSE-S3) (AES256 ) и шифрование на сервере с ключами KMS (SSE-KMS) (aws:kms ). Дополнительную информацию см. в разделе Защита данных с помощью шифрования на сервере в Руководстве пользователя Amazon S3.

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

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

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

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

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

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

• CreateMultipartUpload
• UploadPart
• CompleteMultipartUpload
• AbortMultipartUpload
• ListParts
• ListMultipartUploads

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

Описание

  upload-part-copy
--bucket <value>
--copy-source <value>
[--copy-source-if-match <value>]
[--copy-source-if-modified-since <value>]
[--copy-source-if-none-match <value>]
[--copy-source-if-unmodified-since <value>]
[--copy-source-range <value>]
--key <value>
--part-number <value>
--upload-id <value>
[--sse-customer-algorithm <value>]
[--sse-customer-key <value>]
[--sse-customer-key-md5 <value>]
[--copy-source-sse-customer-algorithm <value>]
[--copy-source-sse-customer-key <value>]
[--copy-source-sse-customer-key-md5 <value>]
[--request-payer <value>]
[--expected-bucket-owner <value>]
[--expected-source-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]

Параметры

--bucket (строка)

--copy-source (строка)

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

--copy-source-if-modified-since (отметка времени)

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

--copy-source-if-unmodified-since (отметка времени)

--copy-source-range (строка)

--key (строка)

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

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

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

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

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

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

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

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

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

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

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

Включить отладочную запись в журнал.

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

Примеры

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

Следующий пример загрузки части, скопировав данные из существующего объекта в качестве источника данных.

aws s3api upload-part-copy \
    --bucket amzn-s3-demo-bucket \
    --key "Map_Data_June.mp4" \
    --copy-source "amzn-s3-demo-bucket/copy_of_Map_Data_June.mp4" \
    --part-number 1 \
    --upload-id "bq0tdE1CDpWQYRPLHuNG50xAT6pA5D.m_RiBy0ggOH6b13pVRY7QjvLlf75iFdJqp_2wztk5hvpUM2SesXgrzbehG5hViyktrfANpAD0NO.Nk3XREBqvGeZF6U3ipiSm"

Вывод:

{
    "CopyPartResult": {
        "LastModified": "2019-12-13T23:16:03.000Z",
        "ETag": "\"711470fc377698c393d94aed6305e245\""
    }
}

Вывод

CopySourceVersionId -> (строка)

CopyPartResult -> (структура)

ServerSideEncryption -> (строка)

SSECustomerAlgorithm -> (строка)

SSECustomerKeyMD5 -> (строка)

SSEKMSKeyId -> (строка)

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

RequestCharged -> (строка)