Classic/VPC環境で利用できます。
Ncloud Storageバケットに保存されているオブジェクトをコピーして保存します。最大5GBまでのオブジェクトは、同一リージョン内のバケット間でのみコピーできます。
参考
Sub Accountユーザーがこのコマンドを実行するには、View/GetObject(オブジェクトのコピー元が保存されているバケット)および Change/PutObject(オブジェクトのコピー先バケット)アクションの権限が必要です。
構文
copy-object構文は次の通りです。
aws s3api copy-object \
--bucket <bucket> \
--copy-source <copy-source> \
--key <key> \
[--cache-control <cache-control>] \
[--content-disposition <content-disposition>] \
[--content-encoding <content-encoding>] \
[--content-language <content-language>] \
[--content-type <content-type>] \
[--metadata <metadata>] \
[--metadata-directive <metadata-directive>] \
[--storage-class <storage-class>] \
[--server-side-encryption <server-side-encryption>] \
[--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>] \
[--object-lock-mode <object-lock-mode>] \
[--object-lock-retain-until-date <object-lock-retain-until-date>] \
[--object-lock-legal-hold-status <object-lock-legal-hold-status>] \
--endpoint-url <endpoint-url>
参考
単発の COPYで最大5GBサイズのオブジェクトをコピーできます。5GBを超えるオブジェクトをコピーする場合は、upload-part-copyをご使用ください。
オプション
copy-objectの実行時に指定できるオプションについて説明します。
必須オプション
copy-objectの必須オプションです。
| オプション | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
--bucket |
String | Required | バケット名 |
--copy-source |
String | Required | コピー元のオブジェクト
|
--key |
String | Required | オブジェクト名 |
任意オプション
copy-objectの任意オプションです。指定しない場合、オプションにはデフォルト値が適用されます。
| オプション | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
--cache-control |
String | Optional | キャッシュ動作 |
--content-disposition |
String | Optional | リクエストデータの表示方法 |
--content-encoding |
String | Optional | リクエストデータのエンコード方法 |
--content-language |
String | Optional | リクエストデータの言語 |
--content-type |
String | Optional | リクエストデータの形式 |
--metadata |
String | Optional | オブジェクトと併せて保存するメタデータ |
--metadata-directive |
String | Optional | メタデータの処理方法
|
--storage-class |
String | Optional | ストレージクラス
|
--server-side-encryption |
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 |
--object-lock-mode |
String | Optional | オブジェクトのリテンションモード
|
--object-lock-retain-until-date |
String | Optional | オブジェクトのリテンション期限
|
--object-lock-legal-hold-status |
String | Optional | リーガルホールドの状態
|
共通オプション
awsコマンドで共通して使用するオプションについては、Ncloud Storageのオプションをご参照ください。
例
オブジェクトのコピーリクエストが成功すると、コピーの識別情報とコピー元のバージョン情報が返されます。
コマンド
バージョン管理が設定されているバケットでオブジェクトをコピーするコマンドの例は次の通りです。
aws s3api copy-object --bucket my-test-bucket \
--key img/copy.png \
--copy-source my-test-bucket/img/image.png \
--endpoint-url=https://kr.ncloudstorage.com
出力
バージョン管理が設定されているバケットでオブジェクトをコピーする出力の例は次の通りです。
{
"CopySourceVersionId": "11111111-2222-3333-4444-555555555551",
"VersionId": "11111111-2222-3333-4444-555555555553",
"ServerSideEncryption": "AES256",
"CopyObjectResult": {
"ETag": "\"7cb4883d8f0eede455af0738a2d83b4b\"",
"LastModified": "2026-09-04T06:32:35Z",
"ChecksumType": "FULL_OBJECT",
"ChecksumCRC32": "35sEXg=="
}
}
関連コマンド
関連コマンドは次の通りです。