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

# CreateCluster
<a name="API_elastic_CreateCluster"></a>

Amazon DocumentDB 탄력적 클러스터를 새로 생성하고 클러스터 구조를 반환합니다.

## Request Syntax
<a name="API_elastic_CreateCluster_RequestSyntax"></a>

```
POST /cluster HTTP/1.1
Content-type: application/json

{
   "adminUserName": "string",
   "adminUserPassword": "string",
   "authType": "string",
   "backupRetentionPeriod": number,
   "clientToken": "string",
   "clusterName": "string",
   "kmsKeyId": "string",
   "preferredBackupWindow": "string",
   "preferredMaintenanceWindow": "string",
   "shardCapacity": number,
   "shardCount": number,
   "shardInstanceCount": number,
   "subnetIds": [ "string" ],
   "tags": { 
      "string" : "string" 
   },
   "vpcSecurityGroupIds": [ "string" ]
}
```

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

요청은 URI 파라미터를 사용하지 않습니다.

## 요청 본문
<a name="API_elastic_CreateCluster_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [adminUserName](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-adminUserName"></a>
Amazon DocumentDB 탄력적 클러스터 관리자의 이름.  
 *제약 조건*:  
+ 1\$163자의 문자 또는 숫자여야 합니다.
+ 첫 자는 문자여야 합니다.
+ 예약어가 될 수는 없습니다.
유형: 문자열  
필수 항목 여부: 예

 ** [adminUserPassword](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-adminUserPassword"></a>
Amazon DocumentDB 탄력적 클러스터 관리자의 암호. 암호는 일체의 인쇄 가능한 ASCII 문자를 포함할 수 있습니다.  
 *제약 조건*:  
+ 8자\$1100자여야 합니다.
+ 포워드 슬래시(/), 큰따옴표(“) 또는 “at” 기호(@)를 포함할 수 없습니다.
유형: 문자열  
필수 항목 여부: 예

 ** [authType](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-authType"></a>
탄력적 클러스터에 액세스하는 데 사용되는 암호를 가져올 위치를 결정하는 데 사용되는 인증 유형입니다. 유효한 형식은 `PLAIN_TEXT` 및 `SECRET_ARN`입니다.  
타입: 문자열  
유효 값: `PLAIN_TEXT | SECRET_ARN`   
필수 사항 여부: 예

 ** [clusterName](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-clusterName"></a>
새 탄력적 클러스터의 이름. 이 파라미터는 소문자 문자열로 저장됩니다.  
 *제약 조건*:  
+ 1\$163자의 문자, 숫자 또는 하이픈으로 구성되어야 합니다.
+ 첫 자는 문자여야 합니다.
+ 하이픈으로 끝나거나 하이픈이 2개 연속으로 포함되어서는 안 됩니다.
 *예*: `my-cluster`   
유형: 문자열  
필수 항목 여부: 예

 ** [shardCapacity](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-shardCapacity"></a>
각 탄력적 클러스터 샤드에 할당된 vCPU 수 최대 값은 64입니다. 허용되는 값은 2, 4, 8, 16, 32, 64입니다.  
유형: 정수  
필수 항목 여부: 예

 ** [shardCount](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-shardCount"></a>
탄력적 클러스터에 할당된 샤드 수. 최대 값은 32입니다.  
유형: 정수  
필수 항목 여부: 예

 ** [backupRetentionPeriod](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-backupRetentionPeriod"></a>
자동 스냅샷이 보관되는 일수입니다.  
유형: 정수  
필수 항목 여부: 아니요

 ** [clientToken](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-clientToken"></a>
탄력적 클러스터의 클라이언트 토큰.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [kmsKeyId](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-kmsKeyId"></a>
새 탄력적 클러스터를 암호화하는 데 사용할 KMS 키 식별자.  
KMS 키 식별자는 KMS 암호화 키의 Amazon 리소스 이름(ARN)입니다. 이 KMS 암호화 키를 소유하고 있는 동일한 Amazon 계정을 사용하여 클러스터를 생성하는 경우, ARN 대신 KMS 키 별칭을 KMS 암호화 키로 사용할 수 있습니다.  
암호화 키가 지정되지 않은 경우 Amazon DocumentDB는 KMS가 사용자 계정에 대해 생성하는 기본 암호화 키를 사용합니다. 계정에는 Amazon 리전마다 다른 기본 암호화 키가 있습니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [preferredBackupWindow](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-preferredBackupWindow"></a>
자동 백업이 활성화된 경우 자동 백업이 생성되는 일일 시간 범위이며, `backupRetentionPeriod` 속성에 의해 결정됩니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [preferredMaintenanceWindow](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-preferredMaintenanceWindow"></a>
시스템 유지 관리를 실행할 수 있는 주 단위 기간(UTC, 협정 세계시)입니다.  
 *형식*: `ddd:hh24:mi-ddd:hh24:mi`   
 *기본*값: 각에 대해 8시간 블록 시간 중에서 임의로 선택되는 30분 기간으로 AWS 리전, 요일에 무작위로 발생합니다.  
 *유효한 요일*: 월, 화, 수, 목, 금, 토, 일  
 *제약 조건*: 최소 30분의 기간.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [shardInstanceCount](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-shardInstanceCount"></a>
탄력적 클러스터의 모든 샤드에 적용되는 복제본 인스턴스 수입니다. `shardInstanceCount` 값이 1이면 라이터 인스턴스가 하나라는 의미이며, 추가 인스턴스는 읽기에 사용할 수 있고 가용성을 개선하는 복제본입니다.  
유형: 정수  
필수 항목 여부: 아니요

 ** [subnetIds](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-subnetIds"></a>
새 탄력적 클러스터의 Amazon EC2 서브넷 ID.  
유형: 문자열 배열  
필수 여부: 아니요

 ** [tags](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-tags"></a>
새 탄력적 클러스터에 할당할 태그.  
유형: 문자열 간 맵  
키 길이 제약 조건: 최소 길이는 1. 최대 길이 128.  
키 패턴: `(?!aws:)[a-zA-Z+-=._:/]+`   
값 길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 256입니다.  
필수 여부: 아니요

 ** [vpcSecurityGroupIds](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-vpcSecurityGroupIds"></a>
새 탄력적 클러스터에 연결할 EC2 VPC 보안 그룹의 목록.  
유형: 문자열 배열  
필수 항목 여부: 아니요

## 응답 구문
<a name="API_elastic_CreateCluster_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "cluster": { 
      "adminUserName": "string",
      "authType": "string",
      "backupRetentionPeriod": number,
      "clusterArn": "string",
      "clusterEndpoint": "string",
      "clusterName": "string",
      "createTime": "string",
      "kmsKeyId": "string",
      "preferredBackupWindow": "string",
      "preferredMaintenanceWindow": "string",
      "shardCapacity": number,
      "shardCount": number,
      "shardInstanceCount": number,
      "shards": [ 
         { 
            "createTime": "string",
            "shardId": "string",
            "status": "string"
         }
      ],
      "status": "string",
      "subnetIds": [ "string" ],
      "vpcSecurityGroupIds": [ "string" ]
   }
}
```

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

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [cluster](#API_elastic_CreateCluster_ResponseSyntax) **   <a name="documentdb-elastic_CreateCluster-response-cluster"></a>
생성된 새 탄력적 클러스터.  
타입: [Cluster](API_elastic_Cluster.md) 객체

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

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

 ** AccessDeniedException **   
작업을 수행할 권한이 충분하지 않을 때 발생하는 예외.    
 ** message **   
액세스가 거부된 이유를 설명하는 오류 메시지입니다.
HTTP 상태 코드: 403

 ** ConflictException **   
액세스 충돌이 발생했습니다.    
 ** resourceId **   
액세스 충돌이 발생한 리소스의 ID입니다.  
 ** resourceType **   
액세스 충돌이 발생한 리소스의 유형입니다.
HTTP 상태 코드: 409

 ** InternalServerException **   
내부 서버 오류가 발생했습니다.  
HTTP 상태 코드: 500

 ** ServiceQuotaExceededException **   
작업에 대한 서비스 할당량을 초과했습니다.  
HTTP 상태 코드: 402

 ** ThrottlingException **   
요청 조절로 인해 요청이 거부되면 ThrottlingException이 발생합니다.    
 ** retryAfterSeconds **   
작업을 재시도하기 전에 대기하는 시간(초)입니다.
HTTP 상태 코드: 429

 ** ValidationException **   
유효성 검사 예외를 정의하는 구조.    
 ** fieldList **   
유효성 검사 예외가 발생한 필드의 목록입니다.  
 ** message **   
유효성 검사 예외를 설명하는 오류 메시지입니다.  
 ** reason **   
검증 예외가 발생한 이유입니다(`unknownOperation`, `cannotParse`, `fieldValidationFailed` 또는 `other` 중 하나).
HTTP 상태 코드: 400

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

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