CopyObject (SOAP API)

説明

ソースオブジェクトのキーとバケット、およびターゲット送信先のキーとバケットを指定すると、CopyObject オペレーションによってオブジェクトのコピーが作成されます。

オブジェクトをコピーするときは、すべてのメタデータを保持する (デフォルト) か、新しいメタデータを指定できます。ただし、ACL は保持されず、リクエストを行ったユーザーに対して private に設定されます。デフォルトの ACL 設定を上書きするには、コピーリクエストを生成するときに新しい ACL を指定します。詳細については、「ACL によるアクセス管理」を参照してください。

すべてのコピーリクエストには認証が必要です。さらに、ソースオブジェクトへの read アクセスと、送信先バケットへの write アクセスが必要です。詳細については、「認証アクセスの使用」を参照してください。

Etag が一致するかどうか、オブジェクトが指定された日付の前後に変更されたかどうかなど、特定の条件下でのみオブジェクトをコピーするには、リクエストパラメータ CopySourceIfUnmodifiedSince、CopyIfUnmodifiedSince、CopySourceIfMatch、または CopySourceIfNoneMatch を使用します。

リクエストの構文

<CopyObject xmlns="http://bucket_name.s3.amazonaws.com/2006-03-01">
  <SourceBucket>source_bucket</SourceBucket>
  <SourceObject>source_object</SourceObject>
  <DestinationBucket>destination_bucket</DestinationBucket>
  <DestinationObject>destination_object</DestinationObject>
  <MetadataDirective>{REPLACE | COPY}</MetadataDirective>
  <Metadata>
    <Name>metadata_name</Name>
    <Value>metadata_value</Value>
  </Metadata>
  ...
  <AccessControlList>
    <Grant>
      <Grantee xsi:type="user_type">
        <ID>user_id</ID>
        <DisplayName>display_name</DisplayName>
      </Grantee>
      <Permission>permission</Permission>
    </Grant>
    ...
  </AccessControlList>
  <CopySourceIfMatch>etag</CopySourceIfMatch>
  <CopySourceIfNoneMatch>etag</CopySourceIfNoneMatch>
  <CopySourceIfModifiedSince>date_time</CopySourceIfModifiedSince>
  <CopySourceIfUnmodifiedSince>date_time</CopySourceIfUnmodifiedSince>
  <AWSAccessKeyId>AWSAccessKeyId</AWSAccessKeyId>
  <Timestamp>TimeStamp</Timestamp>
  <Signature>Signature</Signature>
</CopyObject>

リクエストパラメータ

レスポンスの構文

<CopyObjectResponse xmlns="http://bucket_name.s3.amazonaws.com/2006-03-01">
  <CopyObjectResponse>
    <ETag>"etag"</ETag>
    <LastModified>timestamp</LastModified>
  </CopyObjectResponse>
</CopyObjectResponse>

レスポンス要素

以下は、レスポンス要素のリストです。

一般的なレスポンス要素については、「REST エラーレスポンスヘッダーの使用」を参照してください。

特殊なエラー

このオペレーションには特別なエラーはありません。一般的な Amazon S3 のエラーについては、「エラーコードのリスト」を参照してください。

例

このサンプルは、flotsam オブジェクト (pacific バケット) を jetsam オブジェクト (atlantic バケット) にコピーし、そのメタデータを維持します。

リクエスト例

<CopyObject xmlns="http://doc.s3.amazonaws.com/2006-03-01">
  <SourceBucket>pacific</SourceBucket>
  <SourceObject>flotsam</SourceObject>
  <DestinationBucket>atlantic</DestinationBucket>
  <DestinationObject>jetsam</DestinationObject>
  <AWSAccessKeyId>AKIAIOSFODNN7EXAMPLE</AWSAccessKeyId>
  <Timestamp>2008-02-18T13:54:10.183Z</Timestamp>
  <Signature>Iuyz3d3P0aTou39dzbq7RrtSFmw=</Signature>
</CopyObject>

レスポンス例

<CopyObjectResponse xmlns="http://doc.s3.amazonaws.com/2006-03-01">
  <CopyObjectResponse>
    <ETag>"828ef3fdfa96f00ad9f27c383fc9ac7f"</ETag>
    <LastModified>2008-02-18T13:54:10.183Z</LastModified>
  </CopyObjectResponse>
</CopyObjectResponse>

この例では、ワンダーランドバケットから「tweedledee」オブジェクトをワンダーランドバケットの「tweedledum」オブジェクトにコピーし、メタデータを置き換えます。

リクエスト例

<CopyObject xmlns="http://doc.s3.amazonaws.com/2006-03-01">
  <SourceBucket>wonderland</SourceBucket>
  <SourceObject>tweedledee</SourceObject>
  <DestinationBucket>wonderland</DestinationBucket>
  <DestinationObject>tweedledum</DestinationObject>
  <MetadataDirective >REPLACE</MetadataDirective >
  <Metadata>
    <Name>Content-Type</Name>
    <Value>text/plain</Value>
  </Metadata>
  <Metadata>
    <Name>relationship</Name>
    <Value>twins</Value>
  </Metadata>
  <AWSAccessKeyId>AKIAIOSFODNN7EXAMPLE</AWSAccessKeyId>
  <Timestamp>2008-02-18T13:54:10.183Z</Timestamp>
  <Signature>Iuyz3d3P0aTou39dzbq7RrtSFmw=</Signature>
</CopyObject>

レスポンス例

<CopyObjectResponse xmlns="http://doc.s3.amazonaws.com/2006-03-01">
  <CopyObjectResponse>
    <ETag>"828ef3fdfa96f00ad9f27c383fc9ac7f"</ETag>
    <LastModified>2008-02-18T13:54:10.183Z</LastModified>
  </CopyObjectResponse>
</CopyObjectResponse>

関連リソース