Copy Object
AWS S3内の指定のバケットにオブジェクトをコピーします。
異なるリージョンに作成されたバケット間ではオブジェクトをコピーできません。
オプション
| フィールド | 定義 | タイプ | 必須 |
|---|---|---|---|
|
リージョン（Region） |
AWS S3バケットのリージョン。使用するAWS S3バケットのリージョンを選択します。 |
ドロップダウン | 正 |
|
規定ACL（Canned ACL） |
オブジェクトに適用する規定アクセス制御リスト（Canned Access Control List）（ACL）のタイプをドロップダウンメニューから選択します。 ドロップダウンメニューから
|
ドロップダウン | 正 |
入力
| フィールド | 定義 | タイプ | 必須 |
|---|---|---|---|
|
ソース（Source） |
|||
|
バケット（Bucket） |
ソースバケットの名前。 |
テキスト | 正 |
|
キー（Key） |
ソースオブジェクトのキー。 |
テキスト | 正 |
|
バージョンID（Version ID） |
コピーするオブジェクトの現行バージョンの一意のバージョンID。 空で残した場合、最新のオブジェクトバージョンがコピーされます。 バージョンIDの値がnullのときは、「null」という文字列を入力します。 |
テキスト | FALSE |
|
サーバー側暗号化顧客アルゴリズム（Server Side Encryption Customer Algorithm） |
オブジェクトの暗号化に使用するアルゴリズムを指定します。 たとえば、 |
テキスト | FALSE |
|
サーバー側暗号化顧客キー（Server Side Encryption Customer Key） |
ソースオブジェクトの復号に使用される、AWS S3の顧客提供の暗号化キーを指定します。 このヘッダーに指定する暗号化キーは、ソースオブジェクトの作成時に使用されたキーでなければなりません。 |
テキスト | FALSE |
|
サーバー側暗号化顧客キーMD5（Server Side Encryption Customer Key MD5） |
RFC 1321に準拠した、暗号化キーの128ビットMD5ダイジェストを指定します。 |
テキスト | FALSE |
|
想定バケット所有者（Expected Bucket Owner） |
想定されるソースバケット所有者のアカウントID。 別のアカウントがソースバケットを所有する場合、リクエストはHTTP 403（アクセス拒否）エラーで失敗します。 |
テキスト | FALSE |
|
一致した場合（If Match） |
オブジェクトのエンティティタグ（ETag）が指定のタグと一致する場合にオブジェクトをコピーします。 |
テキスト | FALSE |
|
指定日時以降に変更されている場合（If Modified Since） |
指定した日時以降に変更されている場合にオブジェクトをコピーします。 たとえば、 |
テキスト | FALSE |
|
一致なしの場合（If None Match） |
オブジェクトのETagが指定のETagと異なる場合にオブジェクトをダウンロードします。 |
テキスト | FALSE |
|
指定日時以降に未変更の場合（If Unmodified Since） |
指定した日時以降に変更されていない場合にオブジェクトをコピーします。 たとえば、 |
テキスト | FALSE |
|
宛先（Destination） |
|||
|
バケット（Bucket） |
宛先バケットの名前。 |
テキスト | 正 |
|
キー（Key） |
宛先オブジェクトのキー。最小の長さは1です。 |
テキスト | 正 |
|
フルコントロールを付与（Grant Full Control） |
オブジェクトに対する参照、更新、ACP参照、ACP更新権限をリストされたアカウントに付与します。 付与の対象者ごとにキー/値のペアを指定します。キーは次のいずれかです。
たとえば、 このフィールドは、ユーザーが正規ACL（Canned ACL）フィールドで |
テキストのリスト | FALSE |
|
参照権限を付与（Grant Read） |
オブジェクトデータとメタデータを読み取る権限をリストされたアカウントに付与します。 付与の対象者ごとにキー/値のペアを指定します。キーは次のいずれかです。
たとえば、 このフィールドは、ユーザーが正規ACL（Canned ACL）フィールドで |
テキストのリスト | FALSE |
|
ACP参照権限を付与（Grant Read ACP） |
オブジェクトのACLを読み取る権限をリストされたアカウントに付与します。 付与の対象者ごとにキー/値のペアを指定します。キーは次のいずれかです。
たとえば、 このフィールドは、ユーザーが正規ACL（Canned ACL）フィールドで |
テキストのリスト | FALSE |
|
ACP更新権限を付与（Grant Write ACP） |
オブジェクトのACLを書き込む権限をリストされたアカウントに付与します。 付与の対象者ごとにキー/値のペアを指定します。キーは次のいずれかです。
たとえば、 このフィールドは、ユーザーが正規ACL（Canned ACL）フィールドで |
テキストのリスト | FALSE |
|
メタデータディレクティブ（Metadata Directive） |
メタデータをソースオブジェクトからコピーするか、リクエストで提供されたメタデータに置き換えるかを指定します。
|
ドロップダウン | FALSE |
|
オブジェクトロック法的保留（Object Lock Legal Hold） |
コピーしたオブジェクトに法的保留を適用するかどうかを指定します。
|
ドロップダウン | FALSE |
|
コンテンツMD5（Content MD5） |
Base64エンコードされた128ビットのMD5ダイジェスト。RFC 1864に従ってヘッダーはありません。入力は、最初に送信されたデータと同じデータであることを確認するメッセージ整合性チェックとして使用されます。 RESTリクエスト認証の詳細については、REST認証を参照してください。 オブジェクトロック法的保留（Object Lock Legal Hold）フィールドと併用されます。 |
テキスト | FALSE |
|
オブジェクトロックモード（Object Lock Mode） |
コピーしたオブジェクトに適用するオブジェクトロックモード。
|
ドロップダウン | FALSE |
|
オブジェクトロック保持期限（Object Lock Retain Until Date） |
コピーしたオブジェクトのオブジェクトロックを期限切れにする日時。 |
テキスト | FALSE |
|
リクエスト支払者（Request Payer） |
リクエストが課金の対象であることを依頼者が知っていることを確認します。 |
ドロップダウン | FALSE |
|
サーバー側暗号化（Server Side Encryption） |
このオブジェクトをAWS S3に保存する際に使用されるサーバー側暗号化アルゴリズム。 |
ドロップダウン | FALSE |
|
サーバー側暗号化AWS KMSキーID（Server Side Encryption AWS KMS Key ID） |
オブジェクトの暗号化に使用するAWS KMSキーIDを指定します。 |
テキスト | FALSE |
|
サーバー側暗号化バケットキー有効（Server Side Encryption Bucket Key Enabled） |
AWS S3が、AWS KMS（SSE-KMS）を使ったサーバー側暗号化によるオブジェクトの暗号化にS3バケットキーを使用する場合は このヘッダーをtrueに設定すると、AWS S3は、SSE-KMSを使ったオブジェクト暗号化用のS3バケットキーを使用します。 |
True/False | FALSE |
|
サーバー側暗号化コンテキスト（Server Side Encryption Context） |
オブジェクトの暗号化に使用するAWS KMS暗号化コンテキストを指定します。 このヘッダーの値は、暗号化コンテキストのキー/値のペアを保持するJSONが含まれるBase64エンコードされたUTF-8文字列です。 |
テキスト | FALSE |
|
サーバー側暗号化顧客アルゴリズム（Server Side Encryption Customer Algorithm） |
オブジェクトの暗号化に使用するアルゴリズムを指定します （例：AES256）。 |
テキスト | FALSE |
|
サーバー側暗号化顧客キー（Server Side Encryption Customer Key） |
AWS S3がデータの暗号化に使用する顧客提供の暗号化キーを指定します。 この値は、オブジェクトの保存に使った後で破棄されます。AWS S3は暗号化キーを保存しません。 |
テキスト | FALSE |
|
サーバー側暗号化顧客キーMD5（Server Side Encryption Customer Key MD5） |
RFC 1321に準拠した、暗号化キーの128ビットMD5ダイジェストを指定します。 |
テキスト | FALSE |
|
想定バケット所有者（Expected Bucket Owner） |
想定されるソースバケット所有者のアカウントID。 別のアカウントがソースバケットを所有する場合、リクエストはHTTP 403（アクセス拒否）エラーで失敗します。 |
テキスト | FALSE |
|
ストレージクラス（Storage Class） |
デフォルトでは、AWS S3は新規作成されたオブジェクトの保存に標準ストレージクラスを使用します。標準ストレージクラスは、高い耐久性と高可用性を提供します。
|
ドロップダウン | FALSE |
|
タグディレクティブ（Tagging Directive） |
オブジェクトのタグ設定をソースオブジェクトからコピーするか、リクエストで提供されたタグセットに置き換えるかを指定します。
|
ドロップダウン | FALSE |
|
タグ付け（Tagging） |
オブジェクトの宛先オブジェクトのタグセット。この値は、タグディレクティブ（Tagging Directive）と併用する必要があります。 |
テキスト | FALSE |
|
Webサイトリダイレクトロケーション（Website Redirect Location） |
バケットがWebサイトとして構成されている場合、このオブジェクトへのリクエストを同一バケット内の別のオブジェクトまたは外部URLにリダイレクトします。 |
テキスト | FALSE |
出力
| フィールド | 定義 | タイプ |
|---|---|---|
|
レスポンス（Response ） |
||
|
バージョンID（Version ID） |
新たに作成されたコピーの一意のバージョンID。 |
テキスト |
|
セキュアバージョンID（Source Version ID） |
宛先バケットにコピーされたオブジェクトのバージョン。 |
テキスト |
|
サーバー側暗号化（Server Side Encryption） |
このオブジェクトをAWS S3に保存する際に使用されるサーバー側暗号化アルゴリズム。 |
テキスト |
|
サーバー側暗号化AWS KMSキーID（Server Side Encryption AWS KMS Key ID） |
オブジェクトに使用されたAWSキー管理サービス（AWS KMS）対称顧客管理キーのIDを示します。 |
テキスト |
|
サーバー側暗号化バケットキー有効（Server Side Encryption Bucket Key Enabled） |
コピーされたオブジェクトが、AWS KMSでのサーバー側暗号化（SSE-KMS）のS3バケットキーを使用するかどうかを指定します。 |
テキスト |
|
サーバー側暗号化コンテキスト（Server Side Encryption Context） |
オブジェクトの暗号化に使用するAWS KMS暗号化コンテキストを指定します。 |
テキスト |
|
サーバー側暗号化顧客アルゴリズム（Server Side Encryption Customer Algorithm） |
顧客提供の暗号化キーによるサーバー側暗号化が要求された場合、暗号化アルゴリズムの使用を確認するためにこのヘッダーがレスポンスに含まれます。 |
テキスト |
|
サーバー側暗号化顧客キーMD5（Server Side Encryption Customer Key MD5） |
顧客提供の暗号化キーによるサーバー側暗号化が求められた場合、顧客提供暗号化キーの往復メッセージ整合性検証を提供するためにこのヘッダーがレスポンスに含まれます。 |
テキスト |
|
リクエスト課金済み（Request Charged） |
リクエストが問題なく依頼者に課金されたことを示します。 |
テキスト |
|
最終変更（Last Modified） |
オブジェクトの作成日。 |
数値 |
|
ETag |
新規オブジェクトのETagを返します。ETag は、オブジェクトのコンテンツに対する変更のみを反映し、そのメタデータは反映しません。 |
テキスト |