本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
FailoverGlobalCluster
發生容錯移轉全域叢集時，將指定的次要資料庫叢集提升為全域叢集中的主要資料庫叢集。
使用此作業可回應意外事件，例如主要區域中的區域災難。容錯移轉可能會導致寫入交易資料遺失，而這些資料在容錯移轉事件發生之前未複寫到選擇的次要資料。但是，將所選第二天資料庫叢集上的資料庫執行個體提升為主要寫入器資料庫執行個體的復原程序可確保資料處於交易一致狀態。
請求參數
如需所有動作的一般參數資訊，請參閱《Common Parameters》。
- 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 資源名稱 (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定。
類型：布林值
必要：否
-
回應元素
服務會傳回下列元素。
- GlobalCluster
-
代表 Amazon 文件資料庫全域叢集的資料類型。
類型：GlobalCluster 物件
錯誤
如需所有動作常見錯誤的資訊，請參閱常見錯誤。
- DBClusterNotFoundFault
-
DBClusterIdentifier不參考現有叢集。HTTP狀態碼:
- GlobalClusterNotFoundFault
-
GlobalClusterIdentifier不會參照現有的全域叢集。HTTP狀態碼:
- InvalidDBClusterStateFault
-
叢集不是有效的狀態。
HTTP狀態碼:
- InvalidGlobalClusterStateFault
-
當群集處於此狀態時，請求的操作無法執行。
HTTP狀態碼:
另請參閱
如需有關API在其中一種特定語言中使用此功能的詳細資訊 AWS SDKs，請參閱下列內容：
