# CopyObject (SOAP API)
<a name="SOAPCopyObject"></a>

**注記**  
 SOAP API for Amazon S3 は新規顧客には利用できず、2025 年 8 月 31 日にサポート終了 (EOL) となります。REST API か AWS SDK を使用することをお勧めします。

## 説明
<a name="SOAPCopyObject_Description"></a>

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

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

すべてのコピーリクエストには認証が必要です。さらに、ソースオブジェクトへの *read* アクセスと、送信先バケットへの *write* アクセスが必要です。詳細については、「[認証アクセスの使用](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html)」を参照してください。

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

**注記**  
 大きなオブジェクトをコピーするには、SOAP スタックソケットのタイムアウトを設定する必要がある場合があります。

## リクエストの構文
<a name="SOAPCopyObject_RequestSyntax"></a>

```
 1. <CopyObject xmlns="http://bucket_name.s3.amazonaws.com/2006-03-01">
 2.   <SourceBucket>source_bucket</SourceBucket>
 3.   <SourceObject>source_object</SourceObject>
 4.   <DestinationBucket>destination_bucket</DestinationBucket>
 5.   <DestinationObject>destination_object</DestinationObject>
 6.   <MetadataDirective>{REPLACE | COPY}</MetadataDirective>
 7.   <Metadata>
 8.     <Name>metadata_name</Name>
 9.     <Value>metadata_value</Value>
10.   </Metadata>
11.   ...
12.   <AccessControlList>
13.     <Grant>
14.       <Grantee xsi:type="user_type">
15.         <ID>user_id</ID>
16.         <DisplayName>display_name</DisplayName>
17.       </Grantee>
18.       <Permission>permission</Permission>
19.     </Grant>
20.     ...
21.   </AccessControlList>
22.   <CopySourceIfMatch>etag</CopySourceIfMatch>
23.   <CopySourceIfNoneMatch>etag</CopySourceIfNoneMatch>
24.   <CopySourceIfModifiedSince>date_time</CopySourceIfModifiedSince>
25.   <CopySourceIfUnmodifiedSince>date_time</CopySourceIfUnmodifiedSince>
26.   <AWSAccessKeyId>AWSAccessKeyId</AWSAccessKeyId>
27.   <Timestamp>TimeStamp</Timestamp>
28.   <Signature>Signature</Signature>
29. </CopyObject>
```

## リクエストパラメータ
<a name="SOAPCopyObject_RequestParameters"></a>


|  名前  |  説明  |  必須  | 
| --- | --- | --- | 
|  SourceBucket  | ソースバケットの名前。<br />タイプ: 文字列<br />デフォルト: なし<br />制約: 有効なソースバケット。 |  はい  | 
|  SourceKey  | ソースオブジェクトのキーの名前。<br />タイプ: 文字列<br />デフォルト: なし<br />制約: READ アクセスを持つ有効なソースオブジェクトのキー。 |  はい  | 
|  DestinationBucket  | 宛先 バケットの名前。<br />タイプ: 文字列<br />デフォルト: なし<br />制約: 送信先バケットへの WRITE アクセスが必要です。 |  はい  | 
|  DestinationKey  |  送信先オブジェクトのキー。<br />タイプ: 文字列<br />デフォルト: なし<br />制約: 送信先バケットへの WRITE アクセスが必要です。 |  はい  | 
|  MetadataDirective  |  メタデータをソースオブジェクトからコピーするか、リクエストで指定されたメタデータに置き換えるかを指定します。<br />タイプ: 文字列<br />デフォルト: COPY<br />有効な値: COPY \| REPLACE<br />制約: `COPY` または `REPLACE` 以外の値は即時エラーになります。MetadataDirective ヘッダーが指定され、その値が `REPLACE` に設定されていない限り、オブジェクトをそれ自体にコピーすることはできません。 |  いいえ  | 
|  Metadata  |  オブジェクトに設定するメタデータの名前と値のペアを指定します。MetadataDirective が `COPY` に設定されている場合、すべてのメタデータは無視されます。<br />タイプ: 文字列<br />デフォルト: なし<br />制約: なし。 |  いいえ  | 
|  AccessControlList  | E メールアドレスまたは正規ユーザー ID でユーザーにアクセス権を付与します。<br />タイプ: 文字列<br />デフォルト: なし<br />制約: なし。 |  いいえ  | 
|  CopySourceIfMatch  | エンティティタグ (ETag) が指定されたタグと一致する場合はオブジェクトをコピーします。一致しない場合は、PreconditionFailed を返します。<br />タイプ: 文字列<br />デフォルト: なし<br />制約: なし。Etag が一致しない場合、オブジェクトはコピーされません。 |  いいえ  | 
|  CopySourceIfNoneMatch  | エンティティタグ (ETag) が指定された Etag と異なる場合はオブジェクトをコピーします。それ以外の場合はエラーを返します。<br />タイプ: 文字列<br />デフォルト: なし<br />制約: なし。 |  いいえ  | 
|  CopySourceIfUnmodifiedSince  |  指定された時刻以降に変更されていない場合は、オブジェクトをコピーします。それ以外の場合は、PreconditionFailed を返します。<br />型: dateTime<br />デフォルト: なし |  いいえ  | 
|  CopySourceIfModifiedSince  | 指定された時刻以降に変更された場合は、オブジェクトをコピーします。それ以外の場合は、エラーを返します。<br />型: dateTime<br />デフォルト: なし |  いいえ  | 

## レスポンスの構文
<a name="SOAPCopyObject_ResponseSyntax"></a>

```
1. <CopyObjectResponse xmlns="http://bucket_name.s3.amazonaws.com/2006-03-01">
2.   <CopyObjectResponse>
3.     <ETag>"etag"</ETag>
4.     <LastModified>timestamp</LastModified>
5.   </CopyObjectResponse>
6. </CopyObjectResponse>
```

## レスポンス要素
<a name="SOAPCopyObject_CommonResponseElements"></a>

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

**注記**  
 SOAP API は余分な空白を返しません。追加の空白は REST API によってのみ返されます。


|  名前  |  説明  | 
| --- | --- | 
|  Etag  | 新しいオブジェクトの ETag を返します。ETag は、オブジェクトのコンテンツに加えた変更のみを反映し、メタデータに加えた変更は反映しません。<br />タイプ: 文字列<br />祖先: CopyObjectResult | 
|  LastModified  | オブジェクトの最終変更日時を返します。<br />タイプ: 文字列<br />祖先: CopyObjectResult | 

一般的なレスポンス要素については、「[REST エラーレスポンスヘッダーの使用](https://docs.aws.amazon.com/AmazonS3/latest/userguide/HandlingErrors.html#UsingRESTErrorResponseHeaders)」を参照してください。

## 特殊なエラー
<a name="SOAPCopyObject_SpecialErrors"></a>

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

## 例
<a name="SOAPCopyObject_Examples"></a>

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

### リクエスト例
<a name="SOAPCopyObject_Examples_Request1"></a>

```
1. <CopyObject xmlns="http://doc.s3.amazonaws.com/2006-03-01">
2.   <SourceBucket>pacific</SourceBucket>
3.   <SourceObject>flotsam</SourceObject>
4.   <DestinationBucket>atlantic</DestinationBucket>
5.   <DestinationObject>jetsam</DestinationObject>
6.   <AWSAccessKeyId>AKIAIOSFODNN7EXAMPLE</AWSAccessKeyId>
7.   <Timestamp>2008-02-18T13:54:10.183Z</Timestamp>
8.   <Signature>Iuyz3d3P0aTou39dzbq7RrtSFmw=</Signature>
9. </CopyObject>
```

### レスポンス例
<a name="SOAPCopyObject_Examples_Response1"></a>

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

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

### リクエスト例
<a name="SOAPCopyObject_Examples_Request2"></a>

```
 1. <CopyObject xmlns="http://doc.s3.amazonaws.com/2006-03-01">
 2.   <SourceBucket>wonderland</SourceBucket>
 3.   <SourceObject>tweedledee</SourceObject>
 4.   <DestinationBucket>wonderland</DestinationBucket>
 5.   <DestinationObject>tweedledum</DestinationObject>
 6.   <MetadataDirective >REPLACE</MetadataDirective >
 7.   <Metadata>
 8.     <Name>Content-Type</Name>
 9.     <Value>text/plain</Value>
10.   </Metadata>
11.   <Metadata>
12.     <Name>relationship</Name>
13.     <Value>twins</Value>
14.   </Metadata>
15.   <AWSAccessKeyId>AKIAIOSFODNN7EXAMPLE</AWSAccessKeyId>
16.   <Timestamp>2008-02-18T13:54:10.183Z</Timestamp>
17.   <Signature>Iuyz3d3P0aTou39dzbq7RrtSFmw=</Signature>
18. </CopyObject>
```

### レスポンス例
<a name="SOAPCopyObject_Examples_Response2"></a>

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

## 関連リソース
<a name="SOAPCopyObject_RelatedResources"></a>
+  [PutObject (SOAP API)](SOAPPutObject.md) 
+  [PutObjectInline (SOAP API)](SOAPPutObjectInline.md)