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

# CreateGlobalCluster
<a name="API_CreateGlobalCluster"></a>

建立可跨越多個 的 Amazon DocumentDB 全域叢集 AWS 區域。全域叢集包含一個具有讀寫功能的主要叢集，以及最多 10 個唯讀次要叢集。全域叢集使用儲存型快速複寫跨延遲低於一秒的區域，使用專用基礎設施，不會影響您工作負載的效能。



您可以建立最初為空白的全域叢集，然後將主要叢集和次要叢集新增至該叢集。或者，您可以在建立操作期間指定現有的叢集，而此叢集會成為全域叢集的主要叢集。

**注意**  
此動作僅適用於 Amazon DocumentDB 叢集。

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

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

 ** GlobalClusterIdentifier **   
新全域叢集的叢集識別符。  
類型：字串  
長度限制：長度下限為 1。長度上限為 255。  
模式：`[A-Za-z][0-9A-Za-z-:._]*`  
必要：是

 ** DatabaseName **   
您資料庫的名稱最長可達 64 個英數字元。如果您未提供名稱，Amazon DocumentDB 將不會在您建立的全域叢集中建立資料庫。  
類型：字串  
必要：否

 ** DeletionProtection **   
新全域叢集的刪除保護設定。啟用刪除保護時，無法刪除全域叢集。  
類型：布林值  
必要：否

 ** Engine **   
要用於此叢集的資料庫引擎名稱。  
類型：字串  
必要：否

 ** EngineVersion **   
全域叢集的引擎版本。  
類型：字串  
必要：否

 ** SourceDBClusterIdentifier **   
要用作全域叢集主要叢集的 Amazon Resource Name (ARN)。此為選用參數。  
類型：字串  
必要：否

 ** StorageEncrypted **   
新全域叢集的儲存加密設定。  
類型：布林值  
必要：否

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

服務會傳回下列元素。

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

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

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

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

 ** GlobalClusterAlreadyExistsFault **   
`GlobalClusterIdentifier` 已存在。選擇新的全域叢集識別符 （唯一名稱），以建立新的全域叢集。  
HTTP 狀態碼：400

 ** GlobalClusterQuotaExceededFault **   
此帳戶的全域叢集數目已達允許的上限。  
HTTP 狀態碼：400

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

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

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