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

# 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가 해당 리전에서 클러스터를 찾을 수 있도록 식별자에 Amazon 리소스 이름(ARN)을 사용합니다. AWS   
제약 조건:  
+ 기존 보조 클러스터의 식별자와 일치해야 합니다.
+ 최소 길이는 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 **   
DB 클러스터가 유효한 상태가 아닙니다.  
HTTP 상태 코드: 400

 ** InvalidGlobalClusterStateFault **   
클러스터가 이 상태인 동안에는 요청된 작업을 수행할 수 없습니다.  
HTTP 상태 코드: 400

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

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS .NET V4용 SDK](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 Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS Java V2용 SDK](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 PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS Python용 SDK](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)