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

# FailoverDBCluster
<a name="API_FailoverDBCluster"></a>

Memaksa failover untuk sebuah klaster.

Failover untuk klaster mempromosikan salah satu replika Amazon DocumentDB (instans hanya-baca) di klaster menjadi instans primer (penulis klaster).

Jika instans primer gagal, Amazon DocumentDB secara otomatis gagal ke replika Amazon DocumentDB, jika ada. Anda dapat memaksa failover saat ingin mensimulasikan kegagalan instans primer untuk pengujian.

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

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

 ** DBClusterIdentifier **   
Pengidentifikasi klaster untuk memaksa failover. Parameter ini tidak peka huruf besar kecil.  
Batas:  
+ Harus cocok dengan pengidentifikasi `DBCluster` yang ada.
Tipe: String  
Wajib: Tidak

 ** TargetDBInstanceIdentifier **   
Nama instans yang akan dipromosikan ke instans primer.  
Anda harus menentukan pengidentifikasi instans untuk replika Amazon DocumentDB di klaster. Misalnya, `mydbcluster-replica1`.  
Tipe: String  
Wajib: Tidak

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

Elemen berikut dikembalikan oleh layanan.

 ** DBCluster **   
Informasi mendetail tentang klaster.   
Tipe: Objek [DBCluster](API_DBCluster.md)

## Kesalahan
<a name="API_FailoverDBCluster_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

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

 ** InvalidDBInstanceState **   
 Instans yang ditentukan tidak dalam status *tersedia*.   
Kode Status HTTP: 400

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