本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

當發生容錯移轉全域叢集時，將指定的次要資料庫叢集提升為全域叢集中的主要資料庫叢集。

使用此操作來回應意外事件，例如主要區域中的區域災難。容錯移轉可能會導致寫入交易資料遺失，這些資料未在容錯移轉事件發生之前複寫到選擇的次要裝置。不過，將所選第二個資料庫叢集上的資料庫執行個體提升為主要寫入器資料庫執行個體的復原程序會保證資料處於交易一致狀態。

## 請求參數
<a name="API_FailoverGlobalCluster_RequestParameters"></a>

 如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。

 ** GlobalClusterIdentifier **   
套用此操作的 Amazon DocumentDB 全域叢集識別符。識別符是建立叢集時使用者指派的唯一金鑰。換句話說，它是全域叢集的名稱。  
限制條件：  
+ 必須符合現有全域叢集的識別符。
+ 長度下限為 1。長度上限為 255。
模式：`[A-Za-z][0-9A-Za-z-:._]*`  
類型：字串  
長度限制：長度下限為 1。長度上限為 255。  
模式：`[A-Za-z][0-9A-Za-z-:._]*`  
必要：是

 ** TargetDbClusterIdentifier **   
您要提升為全域叢集主要叢集之次要 Amazon DocumentDB 叢集的識別符。使用 Amazon Resource Name (ARN) 做為識別符，讓 Amazon DocumentDB 可以在其 AWS 區域中找到叢集。  
限制條件：  
+ 必須符合現有次要叢集的識別符。
+ 長度下限為 1。長度上限為 255。
模式：`[A-Za-z][0-9A-Za-z-:._]*`  
類型：字串  
長度限制：長度下限為 1。長度上限為 255。  
模式：`[A-Za-z][0-9A-Za-z-:._]*`  
必要：是

 ** AllowDataLoss **   
指定是否允許此全域叢集操作的資料遺失。允許資料遺失會觸發全域容錯移轉操作。  
如果您未指定 `AllowDataLoss`，全域叢集操作會預設為切換。  
限制條件：  
+ 無法與 `Switchover` 參數一起指定。
類型：布林值  
必要：否

 ** Switchover **   
指定是否要切換此全域資料庫叢集。  
限制條件：  
+ 無法與 `AllowDataLoss` 參數一起指定。
類型：布林值  
必要：否

## 回應元素
<a name="API_FailoverGlobalCluster_ResponseElements"></a>

服務會傳回下列元素。

 ** GlobalCluster **   
代表 Amazon DocumentDB 全域叢集的資料類型。  
類型：[GlobalCluster](API_GlobalCluster.md) 物件

## 錯誤
<a name="API_FailoverGlobalCluster_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。

 ** DBClusterNotFoundFault **   
 `DBClusterIdentifier` 不會參考現有的叢集。  
HTTP 狀態碼：404

 ** GlobalClusterNotFoundFault **   
`GlobalClusterIdentifier` 不是指現有的全域叢集。  
HTTP 狀態碼：404

 ** InvalidDBClusterStateFault **   
叢集未處於有效狀態。  
HTTP 狀態碼：400

 ** InvalidGlobalClusterStateFault **   
當叢集處於此狀態時，無法執行請求的操作。  
HTTP 狀態碼：400

## 另請參閱
<a name="API_FailoverGlobalCluster_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/FailoverGlobalCluster)