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

# CopyClusterSnapshot
<a name="API_elastic_CopyClusterSnapshot"></a>

Menyalin snapshot dari cluster elastis.

## Minta Sintaks
<a name="API_elastic_CopyClusterSnapshot_RequestSyntax"></a>

```
POST /cluster-snapshot/snapshotArn/copy HTTP/1.1
Content-type: application/json

{
   "copyTags": boolean,
   "kmsKeyId": "string",
   "tags": { 
      "string" : "string" 
   },
   "targetSnapshotName": "string"
}
```

## Parameter Permintaan URI
<a name="API_elastic_CopyClusterSnapshot_RequestParameters"></a>

Permintaan menggunakan parameter URI berikut.

 ** [snapshotArn](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-uri-snapshotArn"></a>
Pengidentifikasi Amazon Resource Name (ARN) dari snapshot cluster elastis.  
Wajib: Ya

## Isi Permintaan
<a name="API_elastic_CopyClusterSnapshot_RequestBody"></a>

Permintaan menerima data berikut dalam format JSON.

 ** [targetSnapshotName](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-targetSnapshotName"></a>
Pengidentifikasi snapshot cluster elastis baru untuk dibuat dari snapshot cluster 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: `elastic-cluster-snapshot-5`   
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 63.  
Wajib: Ya

 ** [copyTags](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-copyTags"></a>
Setel `true` untuk menyalin semua tag dari snapshot cluster sumber ke snapshot cluster elastis target. Defaultnya adalah `false`.  
Tipe: Boolean  
Wajib: Tidak

 ** [kmsKeyId](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-kmsKeyId"></a>
ID kunci AWS KMS untuk snapshot cluster elastis terenkripsi. ID kunci AWS KMS adalah Nama Sumber Daya Amazon (ARN) AWS , pengidentifikasi kunci KMS, atau alias kunci KMS AWS untuk kunci enkripsi KMS. AWS   
Jika Anda menyalin snapshot cluster elastis terenkripsi dari AWS akun Anda, Anda dapat menentukan nilai `KmsKeyId` untuk mengenkripsi salinan dengan kunci enkripsi AWS S KMS baru. Jika Anda tidak menentukan nilai untuk`KmsKeyId`, maka salinan snapshot cluster elastis dienkripsi dengan kunci `AWS` KMS yang sama dengan snapshot cluster elastis sumber.  
Jika Anda menyalin snapshot cluster elastis yang tidak terenkripsi dan menentukan nilai untuk `KmsKeyId` parameter, kesalahan akan dikembalikan.  
Tipe: String  
Wajib: Tidak

 ** [tags](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-tags"></a>
Tag yang akan ditetapkan ke snapshot cluster elastis.  
Tipe: Peta string ke string  
Batasan Panjang Kunci: Panjang minimum 1. Panjang maksimum 128.  
Pola Kunci: `(?!aws:)[a-zA-Z+-=._:/]+`   
Batasan Panjang Nilai: Panjang minimum 0. Panjang maksimum 256.  
Wajib: Tidak

## Sintaksis Respons
<a name="API_elastic_CopyClusterSnapshot_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "snapshot": { 
      "adminUserName": "string",
      "clusterArn": "string",
      "clusterCreationTime": "string",
      "kmsKeyId": "string",
      "snapshotArn": "string",
      "snapshotCreationTime": "string",
      "snapshotName": "string",
      "snapshotType": "string",
      "status": "string",
      "subnetIds": [ "string" ],
      "vpcSecurityGroupIds": [ "string" ]
   }
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [snapshot](#API_elastic_CopyClusterSnapshot_ResponseSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-response-snapshot"></a>
Mengembalikan informasi tentang snapshot cluster elastis tertentu.  
Tipe: Objek [ClusterSnapshot](API_elastic_ClusterSnapshot.md)

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

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

 ** AccessDeniedException **   
Pengecualian yang terjadi ketika tidak ada izin yang cukup untuk melakukan tindakan.    
 ** message **   
Pesan kesalahan yang menjelaskan mengapa akses ditolak.
Kode Status HTTP: 403

 ** ConflictException **   
Terjadi konflik akses.    
 ** resourceId **   
ID sumber daya di mana ada konflik akses.  
 ** resourceType **   
Jenis sumber daya di mana ada konflik akses.
Kode Status HTTP: 409

 ** InternalServerException **   
Ada kesalahan server internal.  
Kode Status HTTP: 500

 ** ResourceNotFoundException **   
Sumber daya yang ditentukan tidak dapat ditemukan.    
 ** message **   
Pesan kesalahan yang menjelaskan kegagalan.  
 ** resourceId **   
ID sumber daya yang tidak dapat ditemukan.  
 ** resourceType **   
Jenis sumber daya yang tidak dapat ditemukan.
Kode Status HTTP: 404

 ** ServiceQuotaExceededException **   
Kuota layanan untuk tindakan terlampaui.  
Kode Status HTTP: 402

 ** ThrottlingException **   
ThrottlingException akan dilemparkan ketika permintaan ditolak karena pembatasan permintaan.    
 ** retryAfterSeconds **   
Jumlah detik untuk menunggu sebelum mencoba kembali operasi.
Kode Status HTTP: 429

 ** ValidationException **   
Struktur yang mendefinisikan pengecualian validasi.    
 ** fieldList **   
Daftar bidang di mana pengecualian validasi terjadi.  
 ** message **   
Pesan kesalahan yang menjelaskan pengecualian validasi.  
 ** reason **   
Alasan mengapa pengecualian validasi terjadi (salah satu`unknownOperation`,, `cannotParse``fieldValidationFailed`, atau`other`).
Kode Status HTTP: 400

## Lihat Juga
<a name="API_elastic_CopyClusterSnapshot_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-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/CopyClusterSnapshot)