翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

複数の AWS リージョンにまたがることができる Amazon DocumentDB グローバルクラスターを作成します。グローバルクラスターには、1 つの読み取り/書き込み機能を備えたプライマリクラスターと、最大 10 個の読み取り専用のセカンダリクラスターが含まれます。グローバルクラスターは、ワークロードのパフォーマンスに影響を与えることなく、専用のインフラストラクチャを使用して、1 秒未満のレイテンシーでリージョンにわたってストレージベースの高速レプリケーションを使用します。



最初は空のグローバルクラスターを作成し、そこにプライマリとセカンダリを追加できます。または、作成操作中に既存のクラスターを指定し、そのクラスターをグローバルクラスターのプライマリにすることもできます。

**注記**  
このアクションは Amazon DocumentDB クラスターにのみ適用されます。

## リクエストパラメーター
<a name="API_CreateGlobalCluster_RequestParameters"></a>

 すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

 ** GlobalClusterIdentifier **   
新しいグローバルクラスターのクラスター識別子。  
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 255 です。  
パターン: `[A-Za-z][0-9A-Za-z-:._]*`   
必須: はい

 ** DatabaseName **   
データベースの名前を、英数字 64 文字以内で入力します。名前を入力しない場合は、Amazon DocumentDB は作成するグローバルクラスター上にデータベースを作成しません。  
タイプ: 文字列  
必須: いいえ

 ** DeletionProtection **   
新しいグローバルクラスターの削除保護設定。削除保護が有効な場合、グローバルクラスターは削除できません。  
タイプ: ブール値  
必須: いいえ

 ** Engine **   
このクラスターに使用されるデータベースエンジン名。  
タイプ: 文字列  
必須: いいえ

 ** EngineVersion **   
グローバルクラスターのエンジンバージョン。  
タイプ: 文字列  
必須: いいえ

 ** SourceDBClusterIdentifier **   
グローバルクラスターのプライマリクラスターとして使用する Amazon リソースネーム (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 SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/CreateGlobalCluster) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/CreateGlobalCluster) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/CreateGlobalCluster) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CreateGlobalCluster) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/CreateGlobalCluster) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/CreateGlobalCluster) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/CreateGlobalCluster) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/CreateGlobalCluster) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CreateGlobalCluster)