本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
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 Resource Name (ARN)。此為選用參數。
類型：字串
必要：否
- StorageEncrypted
-
新全域叢集的儲存加密設定。
類型：布林值
必要：否
回應元素
服務會傳回下列元素。
- GlobalCluster
-
代表 Amazon DocumentDB 全域叢集的資料類型。
類型：GlobalCluster 物件
錯誤
如需所有動作常見錯誤的資訊，請參閱常見錯誤。
- DBClusterNotFoundFault
-
DBClusterIdentifier不會參考現有的叢集。HTTP 狀態碼：404
- GlobalClusterAlreadyExistsFault
-
GlobalClusterIdentifier已存在。選擇新的全域叢集識別符 （唯一名稱），以建立新的全域叢集。HTTP 狀態碼：400
- GlobalClusterQuotaExceededFault
-
此帳戶的全域叢集數目已達允許的上限。
HTTP 狀態碼：400
- InvalidDBClusterStateFault
-
叢集未處於有效狀態。
HTTP 狀態碼：400
另請參閱
如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
