本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
CreateGlobalCluster
建立可跨越多個多個的 Amazon DocumentDB 全域叢集。 AWS 區域全域叢集包含一個具有讀寫功能的主要叢集，並提供唯讀次要叢集。全域叢集使用以儲存為基礎的快速複寫，跨延遲時間少於一秒的區域，使用專用基礎架構，而不會影響工作負載的效能。
您可以建立一個最初為空的全域叢集，然後在其中新增主叢集和次要叢集。或者，您可以在建立作業期間指定現有叢集，此叢集就會成為全域叢集的主要叢集。
注意
此動作僅適用於 Amazon DocumentDB 叢集。
請求參數
如需所有動作的一般參數資訊，請參閱《Common Parameters》。
- GlobalClusterIdentifier
-
新全域叢集的叢集識別碼。
類型：字串
長度限制：長度下限為 1。長度上限為 255。
模式：
[A-Za-z][0-9A-Za-z-:._]*必要：是
- DatabaseName
-
您資料庫的名稱最長可達 64 個英數字元。如果您未提供名稱，Amazon DocumentDB 將不會在您建立的全域叢集中建立資料庫。
類型：字串
必要：否
- DeletionProtection
-
新全域叢集的刪除保護設定。啟用刪除保護時，無法刪除全域叢集。
類型：布林值
必要：否
- Engine
-
要用於此叢集的資料庫引擎名稱。
類型：字串
必要：否
- EngineVersion
-
全域叢集的引擎版本。
類型：字串
必要：否
- SourceDBClusterIdentifier
-
Amazon 資源名稱 (ARN) 用作全域叢集的主要叢集。此為選用參數。
類型：字串
必要：否
- StorageEncrypted
-
新全域叢集的儲存區加密設定。
類型：布林值
必要：否
回應元素
服務會傳回下列元素。
- GlobalCluster
-
代表 Amazon 文件資料庫全域叢集的資料類型。
類型：GlobalCluster 物件
錯誤
如需所有動作常見錯誤的資訊，請參閱常見錯誤。
- DBClusterNotFoundFault
-
DBClusterIdentifier不參考現有叢集。HTTP 狀態碼：404
- GlobalClusterAlreadyExistsFault
-
GlobalClusterIdentifier已存在。選擇新的全域叢集識別碼 (唯一名稱) 以建立新的全域叢集。HTTP 狀態碼：400
- GlobalClusterQuotaExceededFault
-
此帳戶的全域叢集數目已達到允許的最大值。
HTTP 狀態碼：400
- InvalidDBClusterStateFault
-
叢集不是有效的狀態。
HTTP 狀態碼：400
另請參閱
如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊，請參閱下列內容：
