Classic/VPC環境で利用できます。
Ncloud Storageバケットに保存されているオブジェクトをコピーして、マルチパートアップロードのパートでアップロードします。
参考
Sub Accountユーザーがこのコマンドを実行するには、View/GetObject(オブジェクトのコピー元が保存されているバケット)および Change/PutObject(オブジェクトのコピー先バケット)アクションの権限が必要です。
構文
upload-part-copy構文は次の通りです。
aws s3api upload-part-copy \
--bucket <bucket> \
--copy-source <copy-source> \
--key <key> \
--part-number <part-number> \
--upload-id <upload-id> \
[--copy-source-range <copy-source-range>] \
[--sse-customer-algorithm <sse-customer-algorithm>] \
[--sse-customer-key <sse-customer-key>] \
[--sse-customer-key-md5 <sse-customer-key-md5>] \
[--copy-source-sse-customer-algorithm <copy-source-sse-customer-algorithm>] \
[--copy-source-sse-customer-key <copy-source-sse-customer-key>] \
[--copy-source-sse-customer-key-md5 <copy-source-sse-customer-key-md5>] \
--endpoint-url <endpoint-url>
オプション
upload-part-copyの実行時に指定できるオプションについて説明します。
必須オプション
upload-part-copyの必須オプションです。
| オプション | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
--bucket |
String | Required | バケット名 |
--copy-source |
String | Required | コピー元のオブジェクト
|
--key |
String | Required | オブジェクト名 |
--part-number |
Integer | Required | アップロード中のパート番号
|
--upload-id |
String | Required | マルチパートアップロード ID |
任意オプション
upload-part-copyの任意オプションです。指定しない場合、オプションにはデフォルト値が適用されます。
| オプション | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
--copy-source-range |
String | Optional | コピー元からコピーするバイトの範囲 |
--sse-customer-algorithm |
String | Optional | ユーザー暗号化アルゴリズム (AES256) |
--sse-customer-key |
String | Optional | ユーザー提供の暗号化キー |
--sse-customer-key-md5 |
String | Optional | ユーザー提供暗号化キーの MD5 |
--copy-source-sse-customer-algorithm |
String | Optional | コピー元のユーザー暗号化アルゴリズム (AES256) |
--copy-source-sse-customer-key |
String | Optional | コピー元のユーザー提供の暗号化キー |
--copy-source-sse-customer-key-md5 |
String | Optional | コピー元のユーザー提供暗号化キーの MD5 |
共通オプション
awsコマンドで共通して使用するオプションについては、Ncloud Storageのオプションをご参照ください。
例
パートのコピーリクエストが成功すると、コピーされたパートの識別情報とコピー元のバージョン情報が返されます。
コマンド
コマンドの例は次の通りです。
aws s3api upload-part-copy --bucket my-test-bucket \
--key copied-large.bin \
--part-number 1 \
--upload-id {upload_id} \
--copy-source my-test-bucket/large.bin \
--endpoint-url=https://kr.ncloudstorage.com
出力
出力の例は次の通りです。
{
"ServerSideEncryption": "AES256",
"CopyPartResult": {
"ETag": "\"6caef151b75db9c5c62d1ff002024964\"",
"LastModified": "2026-09-04T06:18:18Z"
}
}
関連コマンド
関連コマンドは次の通りです。