Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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

**catatan**  
 SOAP API untuk Amazon S3 tidak tersedia untuk pelanggan baru, dan mendekati End of Life (EOL) pada 31 Agustus 2025. Kami menyarankan Anda menggunakan REST API atau AWS SDK. 

## Deskripsi
<a name="SOAPCopyObject_Description"></a>

`CopyObject`Operasi membuat salinan objek ketika Anda menentukan kunci dan bucket dari objek sumber dan kunci dan bucket tujuan target. 

Saat menyalin objek, Anda dapat mempertahankan semua metadata (default) atau menentukan metadata baru. Namun, ACL tidak dipertahankan dan diatur `private` untuk pengguna yang membuat permintaan. Untuk mengganti setelan ACL default, tentukan ACL baru saat membuat permintaan salinan. Untuk informasi lebih lanjut, lihat [Menggunakan ACL](https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3_ACLs_UsingACLs.html).

Semua permintaan salinan harus diautentikasi. Selain itu, Anda harus memiliki * akses * baca ke objek sumber dan * akses * menulis ke bucket tujuan. Untuk informasi selengkapnya, lihat [ Menggunakan Akses Auth. ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html) 

Untuk hanya menyalin objek dalam kondisi tertentu, seperti apakah Etag cocok atau apakah objek dimodifikasi sebelum atau setelah tanggal tertentu, gunakan parameter permintaan`CopySourceIfUnmodifiedSince`,, `CopyIfUnmodifiedSince``CopySourceIfMatch`, atau`CopySourceIfNoneMatch`. 

**catatan**  
 Anda mungkin perlu mengonfigurasi batas waktu soket tumpukan SOAP untuk menyalin objek besar. 

## Sintaksis Permintaan
<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>
```

## Parameter Permintaan
<a name="SOAPCopyObject_RequestParameters"></a>


|  Nama  |  Deskripsi  |  Diperlukan  | 
| --- | --- | --- | 
|  SourceBucket  | Nama bucket sumber.<br />Tipe: String<br />Default: Tidak Ada<br />Kendala: Bucket sumber yang valid. |  Ya  | 
|  SourceKey  | Nama kunci dari objek sumber.<br />Tipe: String<br />Default: Tidak Ada<br />Batasan: Kunci untuk objek sumber yang valid yang memiliki akses BACA. |  Ya  | 
|  DestinationBucket  | Nama bucket tujuan.<br />Tipe: String<br />Default: Tidak Ada<br />Kendala: Anda harus memiliki akses WRITE ke bucket tujuan. |  Ya  | 
|  DestinationKey  |  Kunci objek tujuan.<br />Tipe: String<br />Default: Tidak Ada<br />Kendala: Anda harus memiliki akses WRITE ke bucket tujuan. |  Ya  | 
|  MetadataDirective  |  Menentukan apakah metadata disalin dari objek sumber atau diganti dengan metadata yang disediakan dalam permintaan.<br />Tipe: String<br />Default: COPY<br />Nilai yang valid: COPY \| REPLACE<br />Kendala: Nilai selain `COPY` atau `REPLACE` akan mengakibatkan kesalahan langsung. Anda tidak dapat menyalin objek ke dirinya sendiri kecuali MetadataDirective header ditentukan dan nilainya ditetapkan ke`REPLACE`. |  Tidak  | 
|  Metadata  |  Menentukan pasangan nama-nilai metadata untuk disetel untuk objek.Jika disetel ke`COPY`, MetadataDirective semua metadata diabaikan.<br />Tipe: String<br />Default: Tidak Ada<br />Kendala: Tidak ada. |  Tidak  | 
|  AccessControlList  | Memberikan akses ke pengguna melalui alamat email atau ID pengguna kanonik.<br />Tipe: String<br />Default: Tidak ada<br />Batasan: Tidak Ada |  Tidak  | 
|  CopySourceIfMatch  | Menyalin objek jika tag entitasnya (ETag) cocok dengan tag yang ditentukan; jika tidak, kembalikan a PreconditionFailed.<br />Tipe: String<br />Default: Tidak Ada<br />Kendala: Tidak ada. Jika Etag tidak cocok, objek tidak disalin. |  Tidak  | 
|  CopySourceIfNoneMatch  | Menyalin objek jika tag entitasnya (ETag) berbeda dari Etag yang ditentukan; jika tidak mengembalikan kesalahan.<br />Tipe: String<br />Default: Tidak Ada<br />Kendala: Tidak ada.  |  Tidak  | 
|  CopySourceIfUnmodifiedSince  |  Menyalin objek jika belum dimodifikasi sejak waktu yang ditentukan; jika tidak mengembalikan a PreconditionFailed.<br />Jenis: DateTime<br />Default: Tidak Ada |  Tidak  | 
|  CopySourceIfModifiedSince  | Menyalin objek jika telah dimodifikasi sejak waktu yang ditentukan; jika tidak mengembalikan kesalahan.<br />Jenis: DateTime<br />Default: Tidak Ada |  Tidak  | 

## Sintaksis Respons
<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>
```

## Elemen Respons
<a name="SOAPCopyObject_CommonResponseElements"></a>

Berikut ini adalah daftar elemen respons.

**catatan**  
 API SOAP tidak mengembalikan spasi putih tambahan. Spasi tambahan hanya dikembalikan oleh REST API. 


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  Etag  | Mengembalikan etag objek baru. ETag hanya mencerminkan perubahan pada konten objek, bukan metadatanya.<br />Tipe: String<br />Leluhur: CopyObjectResult | 
|  LastModified  | Mengembalikan tanggal objek terakhir diubah.<br />Tipe: String<br />Leluhur: CopyObjectResult | 

Untuk informasi tentang elemen respons umum, lihat [ Menggunakan Header Respon Kesalahan REST. ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/HandlingErrors.html#UsingRESTErrorResponseHeaders)

## Kesalahan Khusus
<a name="SOAPCopyObject_SpecialErrors"></a>

Tidak ada kesalahan khusus untuk operasi ini. Untuk informasi tentang kesalahan Amazon S3 umum, lihat[Daftar kode kesalahan](ErrorResponses.md#ErrorCodeList).

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

Contoh ini menyalin objek `flotsam` dari bucket `pacific` ke objek `jetsam` dari bucket `atlantic`, dengan mempertahankan metadatanya.

### Permintaan Sampel
<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>
```

### Contoh Respons
<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>
```

Contoh ini menyalin objek “tweedledee” dari bucket wonderland ke objek “tweedledum” dari bucket wonderland, menggantikan metadatanya.

### Permintaan Sampel
<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>
```

### Contoh Respons
<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>
```

## Sumber Daya Terkait
<a name="SOAPCopyObject_RelatedResources"></a>
+  [PutObject (API SABUN)](SOAPPutObject.md) 
+  [PutObjectInline (API SABUN)](SOAPPutObjectInline.md)