オブジェクトのコピー - Amazon Simple Storage Service

オブジェクトのコピー

コピーオペレーションは、Amazon S3 内に既に格納されているオブジェクトのコピーを作成することです。1 回のアトミックオペレーションでコピーできるオブジェクトのサイズは最大 5 GB です。5 GB を超えるオブジェクトをコピーする場合は、マルチパートアップロード API を使用する必要があります。copy オペレーションを使用すると、以下のことができます。

  • オブジェクトの追加コピーを作成する

  • オブジェクトをコピーし、元のオブジェクトを削除することで、オブジェクトの名前を変更する

  • Amazon S3 のロケーション (us-west-1 や欧州など) 間でオブジェクトを移動する

  • オブジェクトメタデータを変更する

    Amazon S3 の各オブジェクトにはメタデータがあります。メタデータは名前と値のペアのセットです。オブジェクトメタデータは、オブジェクトをアップロードするときに設定できます。オブジェクトのアップロード後にはオブジェクトメタデータは変更できません。オブジェクトメタデータを変更する唯一の方法は、オブジェクトのコピーを作成し、メタデータを設定することです。コピーオペレーションでは、コピー元と同じオブジェクトをコピー先に設定します。

各オブジェクトはメタデータを持ちます。システムメタデータの場合もあれば、ユーザー定義メタデータの場合もあります。ユーザーはオブジェクトに対して使用するストレージクラス設定など一部のシステムメタデータを制御し、サーバー側の暗号化を設定します。オブジェクトをコピーするときは、ユーザーが制御するシステムメタデータとユーザー定義メタデータもコピーされます。システムが制御するメタデータは Amazon S3 によってリセットされます。たとえば、オブジェクトをコピーすると、コピーしたオブジェクトの作成日が Amazon S3 によってリセットされます。コピーリクエストの中でこのような値を設定する必要は一切ありません。

オブジェクトをコピーするときは、一部のメタデータ値を更新することができます。たとえば、コピー元のオブジェクトで標準ストレージを使用するように設定してある場合、コピー先のオブジェクトでは低冗長化ストレージを使用するように選択する場合があるかもしれません。また、コピー元のオブジェクトに存在するユーザー定義メタデータの一部を変更することもできます。オブジェクトのユーザー設定可能なメタデータ (システムまたはユーザー定義) をコピー時に更新する場合、メタデータ値の 1 つだけを変更する場合であっても、コピー元オブジェクトに存在するすべてのユーザー設定可能メタデータをリクエスト内で明示的に指定する必要があることにご注意ください。

オブジェクトメタデータの詳細については、「オブジェクトキーとメタデータ」を参照してください。

注記

オブジェクトをコピーするときに、Amazon S3 に保存するターゲットオブジェクトを AWS Key Management Service (AWS KMS) カスタマーマスターキー (CMK)、Amazon S3 マネージド暗号化キー、またはお客様が指定した暗号化キーで暗号化するようリクエストできます。そのために、リクエストで暗号化情報を指定する必要があります。コピーソースが、お客様が指定したキーで、サーバー側の暗号化キーを使用して Amazon S3 に格納されているオブジェクトである場合、Amazon S3 がオブジェクトを復号してコピーできるように、リクエスト内で暗号化情報を指定する必要があります。詳細については、「暗号化を使用したデータの保護」を参照してください。

1 つのリクエストで複数の Amazon S3 オブジェクトをコピーするには、Amazon S3 バッチオペレーションを使用できます。操作するオブジェクトのリストを S3 バッチオペレーション に提供します。S3 バッチオペレーション はそれぞれの API を呼び出して、指定されたオペレーションを実行します。1 つの S3 バッチオペレーション ジョブで、エクサバイトのデータを含む数十億ものオブジェクトに対して、指定されたオペレーションを実行できます。

S3 バッチオペレーション は、進捗状況の追跡、通知の送信、すべてのアクションの詳細な完了レポートの保存を行い、フルマネージド型の、監査可能なサーバーレスエクスペリエンスを提供します。AWS マネジメントコンソール、AWS CLI、AWS SDK、または REST API から、S3 バッチオペレーション を使用できるようになりました。詳細については、「基本: S3 バッチオペレーション」を参照してください。

関連リソース