complete-multipart-upload

Classic/VPC環境で利用できます。

アップロードされたパートを組み合わせてオブジェクトを保存し、マルチパートアップロードを完了します。

参考

Sub Accountユーザーがこのコマンドを実行するには、Change/PutObjectアクションの権限が必要です。

構文

complete-multipart-upload構文は次の通りです。

aws s3api complete-multipart-upload \
    --bucket <bucket> \
    --key <key> \
    --upload-id <upload-id> \
    --multipart-upload <multipart-upload> \
    [--mpu-object-size <mpu-object-size>] \
    [--sse-customer-algorithm <sse-customer-algorithm>] \
    [--sse-customer-key <sse-customer-key>] \
    [--sse-customer-key-md5 <sse-customer-key-md5>] \
    --endpoint-url <endpoint-url>

オプション

complete-multipart-uploadの実行時に指定できるオプションについて説明します。

必須オプション

complete-multipart-uploadの必須オプションです。

オプション	タイプ	必須の有無	説明
`--bucket`	String	Required	バケット名
`--key`	String	Required	オブジェクト名
`--upload-id`	String	Required	マルチパートアップロード ID create-multipart-uploadを参照
`--multipart-upload`	String	Required	結合するパートリスト構文を参照

`--multipart-upload`構文

Shorthand構文

Parts=[{ETag=string, PartNumber=integer},{ETag=string, PartNumber=integer}]

JSON構文

{
  "Parts": [
    {
      "ETag": "string",
      "PartNumber": integer
    }
    ...
  ]
}

任意オプション

complete-multipart-uploadの任意オプションです。指定しない場合、オプションにはデフォルト値が適用されます。

オプション	タイプ	必須の有無	説明
`--mpu-object-size`	Long	Optional	マルチパートアップロードリクエストの予想総オブジェクトサイズ指定されたオブジェクトのサイズ値と実際のサイズ値が異なる場合、HTTP 400 `InvalidRequest`エラーが発生
`--sse-customer-algorithm`	String	Optional	ユーザー暗号化アルゴリズム (AES256)
`--sse-customer-key`	String	Optional	ユーザー提供の暗号化キー
`--sse-customer-key-md5`	String	Optional	ユーザー提供暗号化キーの MD5

共通オプション

awsコマンドで共通して使用するオプションについては、Ncloud Storageのオプションをご参照ください。

例

マルチパートアップロードの完了リクエストが成功すると、作成されたオブジェクトの識別情報と保存先情報が返されます。

コマンド

コマンドの例は次の通りです。

aws s3api complete-multipart-upload --bucket my-test-bucket \
    --key large.bin \
    --upload-id {upload_id} \
    --multipart-upload file://mpu.json \
    --endpoint-url=https://kr.ncloudstorage.com

出力

出力の例は次の通りです。

{
    "ServerSideEncryption": "AES256",
    "Location": "/my-test-bucket/large.bin",
    "Bucket": "my-test-bucket",
    "Key": "large.bin",
    "ETag": "\"12d25956f6cd793eef966af402c1d997-2\"",
    "ChecksumCRC64NVME": "okLxzQM8i2M=",
    "ChecksumType": "FULL_OBJECT"
}