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

# CopyDBClusterSnapshot
<a name="API_CopyDBClusterSnapshot"></a>

Salinan sebuah snapshot dari sebuah klaster.

Untuk menyalin snapshot klaster dari snapshot klaster manual bersama, `SourceDBClusterSnapshotIdentifier` harus menjadi Amazon Resource Name (ARN) dari snapshot klaster bersama. Anda hanya dapat menyalin snapshot klaster DB bersama, baik dienkripsi atau tidak, di Wilayah AWS yang sama.

Untuk membatalkan operasi penyalinan setelah ia berlangsung, hapus snapshot klaster target yang diidentifikasi oleh `TargetDBClusterSnapshotIdentifier` saat snapshot klaster tersebut berada dalam status *menyalin*.

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

 Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).

 ** SourceDBClusterSnapshotIdentifier **   
Pengidentifikasi snapshot klaster yang akan disalin. Parameter ini tidak peka huruf besar kecil.  
Batas:  
+ Harus menentukan snapshot cluster yang valid dalam status yang *tersedia*.
+ Jika snapshot cluster sumber Wilayah AWS sama dengan salinan, tentukan pengenal snapshot yang valid.
+ Jika snapshot cluster sumber berbeda Wilayah AWS atau dimiliki oleh AWS akun lain, tentukan snapshot ARN.
Contoh: `my-cluster-snapshot1`   
Tipe: String  
Diperlukan: Ya

 ** TargetDBClusterSnapshotIdentifier **   
Pengidentifikasi snapshot klaster baru yang akan dibuat dari snapshot klaster sumber. Parameter ini tidak peka huruf besar kecil.  
Batas:  
+ Harus berisi 1 hingga 63 huruf, angka, atau tanda hubung. 
+ Karakter pertama harus berupa surat.
+ Tidak dapat diakhiri dengan tanda hubung atau mengandung dua tanda hubung berturut-turut. 
Contoh: `my-cluster-snapshot2`   
Tipe: String  
Diperlukan: Ya

 ** CopyTags **   
Atur ke `true` untuk menyalin semua tag dari snapshot klaster sumber ke snapshot klaster target, dan sebaliknya `false`. Defaultnya adalah `false`.  
Tipe: Boolean  
Wajib: Tidak

 ** KmsKeyId **   
ID AWS KMS kunci untuk snapshot cluster terenkripsi. ID AWS KMS kunci adalah Nama Sumber Daya Amazon (ARN), pengenal AWS KMS kunci, atau alias kunci untuk AWS KMS kunci enkripsi. AWS KMS   
Jika Anda menyalin snapshot cluster terenkripsi dari Anda Akun AWS, Anda dapat menentukan nilai `KmsKeyId` untuk mengenkripsi salinan dengan kunci enkripsi baru. AWS KMS Jika Anda tidak menentukan nilai untuk`KmsKeyId`, maka salinan snapshot cluster dienkripsi dengan AWS KMS kunci yang sama dengan snapshot cluster sumber.  
Jika Anda menyalin snapshot kluster terenkripsi yang dibagikan dari yang lain Akun AWS, maka Anda harus menentukan nilai untuk. `KmsKeyId`  
Untuk menyalin snapshot kluster terenkripsi ke yang lain Wilayah AWS, atur `KmsKeyId` ke ID AWS KMS kunci yang ingin Anda gunakan untuk mengenkripsi salinan snapshot cluster di Wilayah tujuan. AWS KMS kunci enkripsi khusus untuk tempat Wilayah AWS mereka dibuat, dan Anda tidak dapat menggunakan kunci enkripsi dari satu Wilayah AWS sama lain Wilayah AWS.  
Jika Anda menyalin snapshot klaster yang tidak terenkripsi dan menentukan nilai untuk parameter `KmsKeyId`, kesalahan akan dikembalikan.  
Tipe: String  
Wajib: Tidak

 ** PreSignedUrl **   
URL yang berisi permintaan ditandatangani Signature Version 4 untuk tindakan `CopyDBClusterSnapshot` API Wilayah AWS yang berisi snapshot cluster sumber untuk disalin. Anda harus menggunakan parameter `PreSignedUrl` ketika menyalin snapshot klaster dari Wilayah AWS yang lain.  
Jika Anda menggunakan alat AWS SDK atau AWS CLI, Anda dapat menentukan `SourceRegion` (atau `--source-region` untuk AWS CLI) alih-alih menentukan secara manual`PreSignedUrl`. Menentukan `SourceRegion` secara otomatis menghasilkan URL pre-signed yang merupakan permintaan yang valid untuk operasi yang dapat dijalankan di Wilayah AWS sumber.  
URL yang telah ditetapkan sebelumnya harus berupa permintaan valid untuk tindakan `CopyDBClusterSnapshot` API yang dapat dijalankan di sumber Wilayah AWS yang berisi snapshot cluster yang akan disalin. Permintaan URL yang ditandatangani sebelumnya harus berisi nilai parameter berikut:  
+  `SourceRegion` - ID dari wilayah yang berisi snapshot yang akan disalin.
+  `SourceDBClusterSnapshotIdentifier` - Pengidentifikasi untuk snapshot klaster terenkripsi yang akan disalin. Pengidentifikasi ini harus dalam format Amazon Resource Name (ARN) untuk Wilayah AWS sumber. Misalnya, jika Anda menyalin snapshot klaster terenkripsi dari Wilayah AWS us-east-1, maka `SourceDBClusterSnapshotIdentifier` Anda akan terlihat seperti berikut: `arn:aws:rds:us-east-1:12345678012:sample-cluster:sample-cluster-snapshot`.
+  `TargetDBClusterSnapshotIdentifier` - Pengidentifikasi untuk snapshot klaster baru yang akan dibuat. Parameter ini tidak peka huruf besar kecil.
Tipe: String  
Wajib: Tidak

 **Tags.Tag.N**   
Tag yang akan ditetapkan ke snapshot klaster.  
Tipe: Array objek [Tag](API_Tag.md)  
Wajib: Tidak

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

Elemen berikut dikembalikan oleh layanan.

 ** DBClusterSnapshot **   
Informasi mendetail tentang snapshot klaster.   
Tipe: Objek [DBClusterSnapshot](API_DBClusterSnapshot.md)

## Kesalahan
<a name="API_CopyDBClusterSnapshot_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Jenis Kesalahan Umum](CommonErrors.md).

 ** DBClusterSnapshotAlreadyExistsFault **   
Anda sudah memiliki snapshot klaster dengan pengidentifikasi yang diberikan.  
Kode Status HTTP: 400

 ** DBClusterSnapshotNotFoundFault **   
 `DBClusterSnapshotIdentifier` tidak mengacu ke sebuah snapshot klaster yang ada.   
Kode Status HTTP: 404

 ** InvalidDBClusterSnapshotStateFault **   
Nilai yang diberikan bukan status snapshot klaster yang valid.  
Kode Status HTTP: 400

 ** InvalidDBClusterStateFault **   
Klaster tidak dalam status valid.  
Kode Status HTTP: 400

 ** KMSKeyNotAccessibleFault **   
Terjadi kesalahan saat mengakses AWS KMS kunci.  
Kode Status HTTP: 400

 ** SnapshotQuotaExceeded **   
Permintaan akan menyebabkan Anda melebihi jumlah snapshot yang diizinkan.  
Kode Status HTTP: 400

## Lihat Juga
<a name="API_CopyDBClusterSnapshot_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/CopyDBClusterSnapshot) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/CopyDBClusterSnapshot) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/CopyDBClusterSnapshot) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/CopyDBClusterSnapshot) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CopyDBClusterSnapshot) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/CopyDBClusterSnapshot) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/CopyDBClusterSnapshot) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/CopyDBClusterSnapshot) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/CopyDBClusterSnapshot) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CopyDBClusterSnapshot)