upload-part

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

マルチパートアップロードのパートをアップロードします。アップロードを行うには、まずcreate-multipart-uploadを実行して、マルチパートアップロード IDを作成する必要があります。

参考

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

構文

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

aws s3api upload-part \
    --bucket <bucket> \
    --key <key> \
    --part-number <part-number> \
    --upload-id <upload-id> \
    [--body <body>] \
    [--content-length <content-length>] \
    [--content-md5 <content-md5>] \
    [--sse-customer-algorithm <sse-customer-algorithm>] \
    [--sse-customer-key <sse-customer-key>] \
    [--sse-customer-key-md5 <sse-customer-key-md5>] \
    --endpoint-url <endpoint-url>

参考

Ncloud Storageにアップロード可能な最大サイズは5TiBで、アップロード可能なパートのサイズは5MiB~5GiBです (マルチパートアップロードの最後のパートには最小サイズ制限がありません)。
マルチパートアップロードのパートは最大10,000個まで作成できます。

オプション

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

必須オプション

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

オプション	タイプ	必須の有無	説明
`--bucket`	String	Required	バケット名
`--key`	String	Required	オブジェクト名
`--part-number`	Integer	Required	アップロード中のパート番号パート数は1~10,000まで可能
`--upload-id`	String	Required	マルチパートアップロード ID create-multipart-uploadを参照

任意オプション

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

オプション	タイプ	必須の有無	説明
`--body`	String	Optional	オブジェクトのパスまたはファイル
`--content-length`	Long	Optional	リクエストデータのサイズ (Byte)
`--content-md5`	String	Optional	リクエストデータの Base64エンコードされた128ビット MD5ハッシュ値リクエストデータの整合性検証に使用未入力の場合、自動計算
`--sse-customer-algorithm`	String	Optional	ユーザー暗号化アルゴリズム (AES256)
`--sse-customer-key`	String	Optional	ユーザー提供の暗号化キー
`--sse-customer-key-md5`	String	Optional	ユーザー提供暗号化キーの MD5

共通オプション

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

例

パートのアップロードリクエストが成功すると、パートの識別情報と暗号化情報が返されます。

コマンド

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

aws s3api upload-part --bucket my-test-bucket \
    --key large.bin \
    --part-number 1 \
    --body part-aa \
    --upload-id {upload_id} \
    --endpoint-url=https://kr.ncloudstorage.com

出力

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

{
    "ServerSideEncryption": "AES256",
    "ETag": "\"6d5a86df9e8a0385daf367791d291c94\"",
    "ChecksumCRC32": "NNH2hvw0M94="
}