기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# FailoverDBCluster
<a name="API_FailoverDBCluster"></a>

클러스터에 대한 장애 조치를 강제로 실행합니다.

클러스터에 대한 장애 조치에서 클러스터 내 Amazon DocumentDB 복제본 중 하나(읽기 전용 인스턴스)를 기본 인스턴스(클러스터 라이터)로 승격시킵니다.

Amazon DocumentDB는 기본 인스턴스에 장애가 발생할 경우 Amazon DocumentDB 복제본(있는 경우)에 자동으로 장애 조치됩니다. 테스트를 위해 기본 인스턴스의 실패를 시뮬레이션하려는 경우 장애 조치를 강제할 수 있습니다.

## 요청 파라미터
<a name="API_FailoverDBCluster_RequestParameters"></a>

 모든 작업에 공통되는 파라미터에 대한 정보는 [범용파라미터](CommonParameters.md)를 참조하세요.

 ** DBClusterIdentifier **   
장애 조치를 강제 실행할 클러스터 식별자입니다. 이 파라미터는 대소문자를 구분하지 않습니다.  
제약 조건:  
+ 기존 `DBCluster`의 식별자와 일치해야 합니다.
유형: 문자열  
필수 항목 여부: 아니요

 ** TargetDBInstanceIdentifier **   
기본 인스턴스로 승격시킬 인스턴스의 이름입니다.  
클러스터에서 Amazon DocumentDB 복제본의 인스턴스 식별자를 지정해야 합니다. 예를 들어 `mydbcluster-replica1`입니다.  
유형: String  
필수 항목 여부: 아니요

## 응답 요소
<a name="API_FailoverDBCluster_ResponseElements"></a>

서비스에서 다음 요소를 반환합니다.

 ** DBCluster **   
클러스터에 관한 자세한 정보입니다.  
타입: [DBCluster](API_DBCluster.md) 객체

## 오류
<a name="API_FailoverDBCluster_Errors"></a>

모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** DBClusterNotFoundFault **   
 `DBClusterIdentifier`은 기존 클러스터를 참조하지 않습니다.  
HTTP 상태 코드: 404

 ** InvalidDBClusterStateFault **   
DB 클러스터가 유효한 상태가 아닙니다.  
HTTP 상태 코드: 400

 ** InvalidDBInstanceState **   
 지정된 인스턴스가 *사용 가능*한 상태가 아닙니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_FailoverDBCluster_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/FailoverDBCluster) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/FailoverDBCluster) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/FailoverDBCluster) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/FailoverDBCluster) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/FailoverDBCluster) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/FailoverDBCluster) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/FailoverDBCluster) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/FailoverDBCluster) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/FailoverDBCluster) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/FailoverDBCluster)