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

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