本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
SwitchoverGlobalCluster
將指定的次要 Amazon DocumentDB 叢集切換為全域資料庫叢集中的新主要 Amazon DocumentDB 叢集。
請求參數
如需所有動作的一般參數資訊，請參閱《Common Parameters》。
- GlobalClusterIdentifier
-
要切換之 Amazon DocumentDB 全域資料庫叢集的識別符。識別符是建立叢集時使用者指派的唯一金鑰。換句話說，它是全域叢集的名稱。此參數不區分大小寫。
約束:
-
必須符合現有全域叢集的識別符 (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-:._]*必要：是
-
回應元素
服務會傳回下列元素。
- GlobalCluster
-
代表 Amazon DocumentDB 全域叢集的資料類型。
類型：GlobalCluster 物件
錯誤
如需所有動作常見錯誤的資訊，請參閱常見錯誤。
- DBClusterNotFoundFault
-
DBClusterIdentifier不會參考現有的叢集。HTTP 狀態碼：404
- GlobalClusterNotFoundFault
-
GlobalClusterIdentifier不是指現有的全域叢集。HTTP 狀態碼：404
- InvalidDBClusterStateFault
-
叢集未處於有效狀態。
HTTP 狀態碼：400
- InvalidGlobalClusterStateFault
-
當叢集處於此狀態時，無法執行請求的操作。
HTTP 狀態碼：400
另請參閱
如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容：
