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

# FailoverGlobalCluster
<a name="API_FailoverGlobalCluster"></a>

Mempromosikan cluster DB sekunder yang ditentukan untuk menjadi cluster DB utama di cluster global ketika kegagalan atas cluster global terjadi.

Gunakan operasi ini untuk menanggapi peristiwa yang tidak direncanakan, seperti bencana regional di wilayah primer. Kegagalan dapat mengakibatkan hilangnya data transaksi tulis yang tidak direplikasi ke sekunder yang dipilih sebelum peristiwa failover terjadi. Namun, proses pemulihan yang mempromosikan instans DB pada cluster DB hari kedua yang dipilih menjadi instans DB penulis utama menjamin bahwa data dalam keadaan konsisten secara transaksional.

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

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

 ** GlobalClusterIdentifier **   
Pengidentifikasi cluster global Amazon DocumentDB untuk menerapkan operasi ini. Identifier adalah kunci unik yang ditetapkan oleh pengguna saat cluster dibuat. Dengan kata lain, itu adalah nama cluster global.  
Batas:  
+ Harus cocok dengan pengidentifikasi klaster global yang ada.
+ Panjang minimum 1. Panjang maksimum 255.
Pola: `[A-Za-z][0-9A-Za-z-:._]*`   
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 255.  
Pola: `[A-Za-z][0-9A-Za-z-:._]*`   
Wajib: Ya

 ** TargetDbClusterIdentifier **   
Pengidentifikasi klaster Amazon DocumentDB sekunder yang ingin Anda promosikan ke klaster utama untuk klaster global. Gunakan Amazon Resource Name (ARN) untuk pengidentifikasi sehingga Amazon DocumentDB dapat menemukan cluster di wilayahnya. AWS   
Batas:  
+ Harus cocok dengan identifier dari cluster sekunder yang ada.
+ Panjang minimum 1. Panjang maksimum 255.
Pola: `[A-Za-z][0-9A-Za-z-:._]*`   
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 255.  
Pola: `[A-Za-z][0-9A-Za-z-:._]*`   
Wajib: Ya

 ** AllowDataLoss **   
Menentukan apakah untuk memungkinkan kehilangan data untuk operasi cluster global ini. Mengizinkan kehilangan data memicu operasi failover global.  
Jika Anda tidak menentukan`AllowDataLoss`, operasi cluster global default ke switchover.  
Batas:  
+ Tidak dapat ditentukan bersama dengan `Switchover` parameter.
Tipe: Boolean  
Wajib: Tidak

 ** Switchover **   
Menentukan apakah akan beralih ke cluster database global ini.  
Batas:  
+ Tidak dapat ditentukan bersama dengan `AllowDataLoss` parameter.
Tipe: Boolean  
Wajib: Tidak

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

Elemen berikut dikembalikan oleh layanan.

 ** GlobalCluster **   
Sebuah tipe data yang mewakili sebuah klaster global Amazon DocumentDB.  
Tipe: Objek [GlobalCluster](API_GlobalCluster.md)

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

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

 ** DBClusterNotFoundFault **   
 `DBClusterIdentifier` tidak mengacu ke sebuah klaster yang ada.   
Kode Status HTTP: 404

 ** GlobalClusterNotFoundFault **   
`GlobalClusterIdentifier` tidak mengacu ke sebuah klaster global yang ada.  
Kode Status HTTP: 404

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

 ** InvalidGlobalClusterStateFault **   
Operasi yang diminta tidak dapat dilakukan saat klaster dalam keadaan ini.  
Kode Status HTTP: 400

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