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

# SwitchoverGlobalCluster
<a name="API_SwitchoverGlobalCluster"></a>

Mengalihkan klaster Amazon DocumentDB sekunder yang ditentukan menjadi klaster Amazon DocumentDB utama baru di kluster database global.

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

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

 ** GlobalClusterIdentifier **   
Pengidentifikasi cluster database global Amazon DocumentDB untuk beralih. Identifier adalah kunci unik yang ditetapkan oleh pengguna saat cluster dibuat. Dengan kata lain, itu adalah nama cluster global. Parameter ini tidak peka huruf besar/kecil.  
Batas:  
+ Harus cocok dengan pengidentifikasi klaster global yang ada (database global Amazon DocumentDB).
+ 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 cluster Amazon DocumentDB sekunder untuk mempromosikan ke primer baru untuk cluster database global. Gunakan Amazon Resource Name (ARN) untuk pengidentifikasi sehingga Amazon DocumentDB dapat menemukan cluster di wilayahnya. AWS   
Batas:  
+ Harus cocok dengan pengidentifikasi 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-:._]*`   
Diperlukan: Ya

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