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

# SwitchoverGlobalCluster
<a name="API_SwitchoverGlobalCluster"></a>

指定されたセカンダリ Amazon DocumentDB クラスターをグローバルデータベースクラスターの新しいプライマリ Amazon DocumentDB クラスターに切り替えます。

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

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

 ** 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 DocumentDB が AWS リージョン内のクラスターを見つけることができるように、識別子に Amazon リソースネーム (ARN) を使用します。  
制約:  
+ 既存のセカンダリクラスターの識別子と一致する必要があります。
+ 最小長は 1 です｡ 最大長は 255 です。
パターン: `[A-Za-z][0-9A-Za-z-:._]*`   
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 255 です。  
パターン: `[A-Za-z][0-9A-Za-z-:._]*`   
必須: はい

## レスポンス要素
<a name="API_SwitchoverGlobalCluster_ResponseElements"></a>

以下の要素がサービスによって返されます。

 ** GlobalCluster **   
Amazon DocumentDB グローバルクラスターを表すデータ型。  
型: [GlobalCluster](API_GlobalCluster.md) オブジェクト

## エラー
<a name="API_SwitchoverGlobalCluster_Errors"></a>

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

 ** DBClusterNotFoundFault **   
 `DBClusterIdentifier` は既存のクラスターを参照していません。  
HTTP ステータスコード: 404

 ** GlobalClusterNotFoundFault **   
`GlobalClusterIdentifier` は既存のグローバルクラスターを参照していません。  
HTTP ステータスコード: 404

 ** InvalidDBClusterStateFault **   
クラスターは有効な状態ではありません。  
HTTP ステータスコード: 400

 ** InvalidGlobalClusterStateFault **   
要求された操作は、クラスターがこの状態にある間は実行できません。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_SwitchoverGlobalCluster_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/SwitchoverGlobalCluster)