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

# FailoverGlobalCluster
<a name="API_FailoverGlobalCluster"></a>

グローバルクラスターにフェイルオーバーが発生したときに、指定されたセカンダリ DB クラスターをそのグローバルクラスターのプライマリ DB クラスターに昇格させます。

このオペレーションにより、プライマリリージョンの地域的な災害などの計画外の事象に対応します。どちらのフェイルオーバー方法でも、フェイルオーバーイベントが発生する前に選択したセカンダリにレプリケートされていなかった書き込みトランザクションデータは失われる可能性があります。ただし、選択したセカンダリ DB クラスター上の DB インスタンスをプライマリライター DB インスタンスに昇格させるリカバリプロセスにより、データがトランザクション的に一貫した状態になることが保証されます。

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

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

 ** GlobalClusterIdentifier **   
このオペレーションを適用する 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-:._]*`   
必須: はい

 ** AllowDataLoss **   
このグローバルクラスターオペレーションのデータロスを許可するかどうかを指定します。データロスを許可すると、グローバルフェイルオーバーオペレーションがトリガーされます。  
`AllowDataLoss` を指定しない場合、グローバルクラスターオペレーションはデフォルトでスイッチオーバーになります。  
制約:  
+ `Switchover` パラメータと一緒に指定することはできません。
タイプ: ブール値  
必須: いいえ

 ** Switchover **   
このグローバルデータベースクラスターをスイッチオーバーするかどうかを指定します。  
制約:  
+ `AllowDataLoss` パラメータと一緒に指定することはできません。
タイプ: ブール値  
必須: いいえ

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

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

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

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

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

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

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

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

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

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

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