기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# CreateDBCluster
새 Amazon DocumentDB 클러스터를 생성합니다.
## 요청 파라미터
모든 작업에 공통으로 적용되는 파라미터에 대한 자세한 내용은 [공통 파라미터](CommonParameters.md)를 참조하세요.
** DBClusterIdentifier **
클러스터 식별자입니다. 이 파라미터는 소문자 문자열로 저장됩니다.
제약 조건:
+ 1\$163자의 문자, 숫자 또는 하이픈으로 구성되어야 합니다.
+ 첫 자는 문자여야 합니다.
+ 하이픈으로 끝나거나 하이픈이 2개 연속으로 포함되어서는 안 됩니다.
예시: `my-cluster`
유형: 문자열
필수 항목 여부: 예
** Engine **
이 클러스터에 사용할 데이터베이스 엔진의 이름입니다.
유효한 값: `docdb`
유형: 문자열
필수 항목 여부: 예
**AvailabilityZones.AvailabilityZone.N**
클러스터의 인스턴스를 생성할 수 있는 Amazon EC2 가용 영역의 목록입니다.
유형: 문자열 배열
필수 여부: 아니요
** BackupRetentionPeriod **
자동 백업이 보존되는 일수입니다. 1 이상의 값을 지정해야 합니다.
기본값: 1
제약 조건:
+ 1\$135의 값이어야 합니다.
유형: 정수
필수 항목 여부: 아니요
** DBClusterParameterGroupName **
이 클러스터와 연결할 클러스터 파라미터 그룹의 이름입니다.
유형: 문자열
필수 항목 여부: 아니요
** DBSubnetGroupName **
이 클러스터와 연결할 서브넷 그룹입니다.
제약: 기존의 `DBSubnetGroup` 이름과 일치해야 합니다. 기본값이 아니어야 합니다.
예시: `mySubnetgroup`
유형: 문자열
필수 항목 여부: 아니요
** DeletionProtection **
이 클러스터를 삭제할 수 있는지 없는지를 지정합니다. `DeletionProtection`이 활성화되면 클러스터를 수정하고 `DeletionProtection` 를 비활성화하지 않는 한 클러스터를 삭제할 수 없습니다. `DeletionProtection`은 클러스터가 실수로 삭제되지 않도록 보호합니다.
유형: 부울
필수 항목 여부: 아니요
**EnableCloudwatchLogsExports.member.N**
Amazon CloudWatch Logs로 내보내기에 대해 활성화해야 하는 로그 유형의 목록입니다. 감사 로그 또는 프로파일러 로그를 활성화할 수 있습니다. 자세한 내용은 [Amazon DocumentDB 이벤트 감사](https://docs.aws.amazon.com/documentdb/latest/developerguide/event-auditing.html) 및 [Amazon DocumentDB 작업 프로파일링](https://docs.aws.amazon.com/documentdb/latest/developerguide/profiling.html)을 참조하십시오.
유형: 문자열 배열
필수 여부: 아니요
** EngineVersion **
사용할 데이터베이스 엔진의 버전 번호입니다. `--engine-version`은 기본적으로 최신 주요 엔진 버전으로 설정됩니다. 프로덕션 워크로드의 경우 이 파라미터를 의도한 주요 엔진 버전으로 명시적으로 선언하는 것이 좋습니다.
유형: 문자열
필수 항목 여부: 아니요
** GlobalClusterIdentifier **
새 글로벌 클러스터의 클러스터 식별자입니다.
유형: 문자열
길이 제약: 최소 길이는 1. 최대 길이는 255.
패턴: `[A-Za-z][0-9A-Za-z-:._]*`
필수 여부: 아니요
** KmsKeyId **
암호화된 클러스터의 AWS KMS 키 식별자입니다.
AWS KMS 키 식별자는 AWS KMS 암호화 키의 Amazon 리소스 이름(ARN)입니다. 새 클러스터를 암호화하는 데 사용되는 AWS KMS 암호화 키를 소유 AWS 계정 한 동일한를 사용하여 클러스터를 생성하는 경우 AWS KMS 암호화 AWS KMS 키에 ARN 대신 키 별칭을 사용할 수 있습니다.
`KmsKeyId`에 암호화 키가 지정되어 있지 않은 경우:
+ `StorageEncrypted` 파라미터가 `true`인 경우 Amazon DocumentDB는 기본 암호화 키를 사용합니다.
AWS KMS 는에 대한 기본 암호화 키를 생성합니다 AWS 계정. AWS 계정 에는 각각 다른 기본 암호화 키가 있습니다 AWS 리전.
유형: 문자열
필수 항목 여부: 아니요
** ManageMasterUserPassword **
Amazon Web Services Secrets Manager를 사용하여 마스터 사용자 암호를 관리할지 여부를 지정합니다.
제약 조건: `MasterUserPassword`가 지정된 경우 Amazon Web Services Secrets Manager로 마스터 사용자 암호를 관리할 수 없습니다.
유형: 부울
필수 항목 여부: 아니요
** MasterUsername **
클러스터의 마스터 사용자 이름입니다.
제약 조건:
+ 1\$163자의 문자 또는 숫자여야 합니다.
+ 첫 자는 문자여야 합니다.
+ 선택한 데이터베이스 엔진의 예약어는 사용할 수 없습니다.
유형: 문자열
필수 항목 여부: 아니요
** MasterUserPassword **
마스터 데이터베이스 사용자의 암호입니다. 이 암호에는 슬래시(/), 큰따옴표(") 또는 ‘앳’ 기호(@)를 제외한 인쇄 가능 ASCII 문자가 포함될 수 있습니다.
제약: 8\$1100자여야 합니다.
유형: 문자열
필수 항목 여부: 아니요
** MasterUserSecretKmsKeyId **
Amazon Web Services Secrets Manager에서 자동으로 생성되고 관리되는 보안 암호를 암호화하기 위한 Amazon Web Services KMS 키 식별자입니다. 이 설정은 DB 클러스터용 Amazon Web Services Secrets Manager의 Amazon DocumentDB에서 마스터 사용자 암호를 관리하는 경우에만 유효합니다.
Amazon Web Services KMS 키 식별자는 KMS 키의 키 ARN, 키 ID, 별칭 ARN 또는 별칭 이름입니다. 다른 Amazon Web Services 계정에서 KMS 키를 사용하려면 키 ARN 또는 별칭 ARN을 지정하세요.
`MasterUserSecretKmsKeyId`를 지정하지 않으면 `aws/secretsmanager` KMS 키가 보안 암호를 암호화하는 데 사용됩니다. 보안 암호가 다른 Amazon Web Services 계정에 있는 경우 `aws/secretsmanager` KMS 키를 사용하여 보안 암호를 보안 암호화할 수 없으며 고객 관리형 KMS 키를 사용해야 합니다.
Amazon Web Services 계정에 대한 기본 KMS 키가 있습니다. Amazon Web Services 계정에는 Amazon Web Services 리전마다 다른 기본 KMS 키가 있습니다.
유형: 문자열
필수 항목 여부: 아니요
** NetworkType **
클러스터의 네트워크 유형입니다.
네트워크 유형은 클러스터에 대해 지정된 `DBSubnetGroup`에 의해 결정됩니다. `DBSubnetGroup`은 IPv4 프로토콜 또는 IPv4 및 IPv6 프로토콜(`DUAL`)만 지원할 수 있습니다.
자세한 내용은 Amazon DocumentDB 개발자 안내서의 [VPC의 DocumentDB 클러스터](https://docs.aws.amazon.com/documentdb/latest/developerguide/vpc-clusters.html)를 참조하세요.
유효한 값: `IPV4` \$1 `DUAL`
유형: 문자열
필수 항목 여부: 아니요
** Port **
클러스터의 인스턴스가 연결을 허용하는 포트 번호입니다.
유형: 정수
필수 항목 여부: 아니요
** PreferredBackupWindow **
`BackupRetentionPeriod` 파라미터를 사용하여 자동 백업을 활성화한 경우, 자동 백업이 생성되는 일일 시간 범위입니다.
기본값은 각각에 대해 8시간 블록 시간 중에서 임의로 선택한 30분 기간입니다 AWS 리전.
제약 조건:
+ `hh24:mi-hh24:mi` 형식이어야 합니다.
+ 협정 세계시(UTC)여야 합니다.
+ 원하는 유지 관리 기간과 충돌하지 않아야 합니다.
+ 30분 이상이어야 합니다.
유형: 문자열
필수 항목 여부: 아니요
** PreferredMaintenanceWindow **
시스템 유지 관리를 실행할 수 있는 주 단위 기간(UTC, 협정 세계시)입니다.
형식: `ddd:hh24:mi-ddd:hh24:mi`
기본값은 각에 대해 8시간 블록 시간 중에서 임의로 선택한 30분 기간으로 AWS 리전, 요일에 무작위로 발생합니다.
유효한 요일: 월, 화, 수, 목, 금, 토, 일
제약 조건: 최소 30분의 기간.
유형: 문자열
필수 항목 여부: 아니요
** PreSignedUrl **
현재 지원되지 않습니다.
유형: 문자열
필수 항목 여부: 아니요
** ServerlessV2ScalingConfiguration **
Amazon DocumentDB Serverless 클러스터의 규모 조정 구성을 포함합니다.
유형: [ServerlessV2ScalingConfiguration](API_ServerlessV2ScalingConfiguration.md)객체
필수 여부: 아니요
** StorageEncrypted **
클러스터의 암호화 여부를 지정합니다.
유형: 부울
필수 항목 여부: 아니요
** StorageType **
DB 클러스터와 연결할 스토리지 유형입니다.
Amazon DocumentDB 클러스터의 스토리지 유형에 관한 자세한 내용은 *Amazon DocumentDB 개발자 안내서*의 클러스터 스토리지 구성을 참조하세요.
스토리지 유형에 유효한 값 - `standard | iopt1`
기본값은 `standard `입니다.
스토리지 유형이 `iopt1`로 설정된 Amazon DocumentDB 클러스터를 생성하면 스토리지 유형이 응답에 반환됩니다. 스토리지 유형을 `standard`로 설정하면 스토리지 유형이 반환되지 않습니다.
유형: 문자열
필수 항목 여부: 아니요
**Tags.Tag.N**
클러스터에 할당할 태그입니다.
타입: [Tag](API_Tag.md)객체 배열
필수: 아니요
**VpcSecurityGroupIds.VpcSecurityGroupId.N**
이 클러스터와 연결할 EC2 VPC 보안 그룹 목록입니다.
유형: 문자열 배열
필수 여부: 아니요
## 응답 요소
서비스에서 다음 요소를 반환합니다.
** DBCluster **
클러스터에 관한 자세한 정보입니다.
타입: [DBCluster](API_DBCluster.md) 객체
## 오류
모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.
** DBClusterAlreadyExistsFault **
해당 식별자를 사용하는 클러스터가 이미 있습니다.
HTTP 상태 코드: 400
** DBClusterNotFoundFault **
`DBClusterIdentifier`는 기존 클러스터를 참조하지 않습니다.
HTTP 상태 코드: 404
** DBClusterParameterGroupNotFound **
`DBClusterParameterGroupName`는 기존 클러스터 파라미터 그룹을 참조하지 않습니다.
HTTP 상태 코드: 404
** DBClusterQuotaExceededFault **
클러스터의 최대 허용 할당량에 도달했기 때문에 클러스터를 생성할 수 없습니다.
HTTP 상태 코드: 403
** DBInstanceNotFound **
`DBInstanceIdentifier`는 기존 인스턴스를 참조하지 않습니다.
HTTP 상태 코드: 404
** DBSubnetGroupDoesNotCoverEnoughAZs **
가용 영역이 하나뿐인 경우를 제외하고, 서브넷 그룹의 서브넷은 최소한 두 개의 가용 영역을 포함해야 합니다.
HTTP 상태 코드: 400
** DBSubnetGroupNotFoundFault **
`DBSubnetGroupName`은 기존 서브넷 그룹을 참조하지 않습니다.
HTTP 상태 코드: 404
** GlobalClusterNotFoundFault **
`GlobalClusterIdentifier`는 기존 글로벌 클러스터를 참조하지 않습니다.
HTTP 상태 코드: 404
** InsufficientStorageClusterCapacity **
현재의 작업에 사용할 스토리지가 부족합니다. 사용 가능한 스토리지가 더 많은 다른 가용 영역을 사용하도록 서브넷 그룹을 업데이트하여 이 오류를 해결할 수 있습니다.
HTTP 상태 코드: 400
** InvalidDBClusterStateFault **
클러스터가 유효한 상태가 아닙니다.
HTTP 상태 코드: 400
** InvalidDBInstanceState **
지정된 인스턴스가 *사용 가능*한 상태가 아닙니다.
HTTP 상태 코드: 400
** InvalidDBSubnetGroupStateFault **
서브넷 그룹이 사용 중이므로 삭제할 수 없습니다.
HTTP 상태 코드: 400
** InvalidGlobalClusterStateFault **
클러스터가 이 상태인 동안에는 요청된 작업을 수행할 수 없습니다.
HTTP 상태 코드: 400
** InvalidSubnet **
요청한 서브넷이 올바르지 않거나 공통 Virtual Private Cloud(VPC)에 모두 포함되지 않은 여러 서브넷이 요청되었습니다.
HTTP 상태 코드: 400
** InvalidVPCNetworkStateFault **
서브넷 그룹이 생성된 후에는 변경 사항으로 인해 모든 가용 영역에 적용되지 않습니다.
HTTP 상태 코드: 400
** KMSKeyNotAccessibleFault **
AWS KMS 키에 액세스할 때 오류가 발생했습니다.
HTTP 상태 코드: 400
** NetworkTypeNotSupported **
네트워크 유형은 `DBSubnetGroup` 또는 DB 엔진 버전에서 지원되지 않습니다.
HTTP 상태 코드: 400
** StorageQuotaExceeded **
요청으로 인해 모든 인스턴스에서 사용 가능한 스토리지 허용량을 초과하게 됩니다.
HTTP 상태 코드: 400
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/CreateDBCluster)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/CreateDBCluster)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/CreateDBCluster)
+ [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/CreateDBCluster)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CreateDBCluster)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/CreateDBCluster)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/CreateDBCluster)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/CreateDBCluster)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/CreateDBCluster)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CreateDBCluster)