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

# Cluster
<a name="API_elastic_Cluster"></a>

특정 탄력적 클러스터에 대한 정보를 반환합니다.

## 내용
<a name="API_elastic_Cluster_Contents"></a>

**참고**  
다음 목록에는 필수 파라미터가 먼저 설명되어 있습니다.

 ** adminUserName **   <a name="documentdb-Type-elastic_Cluster-adminUserName"></a>
탄성 클러스터 관리자의 이름입니다.  
유형: 문자열  
필수 항목 여부: 예

 ** authType **   <a name="documentdb-Type-elastic_Cluster-authType"></a>
탄력적 클러스터의 인증 유형입니다.  
타입: 문자열  
유효 값: `PLAIN_TEXT | SECRET_ARN`   
필수 여부: 예

 ** clusterArn **   <a name="documentdb-Type-elastic_Cluster-clusterArn"></a>
탄력적 클러스터의 ARN 식별자.  
유형: 문자열  
필수 항목 여부: 예

 ** clusterEndpoint **   <a name="documentdb-Type-elastic_Cluster-clusterEndpoint"></a>
탄력적 클러스터에 연결하는 데 사용되는 URL입니다.  
유형: 문자열  
필수 항목 여부: 예

 ** clusterName **   <a name="documentdb-Type-elastic_Cluster-clusterName"></a>
Elastic 클러스터의 이름입니다.  
유형: 문자열  
필수 항목 여부: 예

 ** createTime **   <a name="documentdb-Type-elastic_Cluster-createTime"></a>
탄력적 클러스터가 생성된 시간(협정 세계시(UTC)).  
유형: 문자열  
필수 항목 여부: 예

 ** kmsKeyId **   <a name="documentdb-Type-elastic_Cluster-kmsKeyId"></a>
탄력적 클러스터를 암호화하는 데 사용할 KMS 키 식별자입니다.  
유형: 문자열  
필수 항목 여부: 예

 ** preferredMaintenanceWindow **   <a name="documentdb-Type-elastic_Cluster-preferredMaintenanceWindow"></a>
시스템 유지 관리를 실행할 수 있는 주 단위 기간(UTC, 협정 세계시)입니다.  
 *형식*: `ddd:hh24:mi-ddd:hh24:mi`   
유형: 문자열  
필수 항목 여부: 예

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

 ** shardCount **   <a name="documentdb-Type-elastic_Cluster-shardCount"></a>
탄력적 클러스터에 할당된 샤드 수. 최대 값은 32입니다.  
유형: 정수  
필수 여부: 예

 ** status **   <a name="documentdb-Type-elastic_Cluster-status"></a>
Elastic 클러스터의 상태입니다.  
타입: 문자열  
유효 값: `CREATING | ACTIVE | DELETING | UPDATING | VPC_ENDPOINT_LIMIT_EXCEEDED | IP_ADDRESS_LIMIT_EXCEEDED | INVALID_SECURITY_GROUP_ID | INVALID_SUBNET_ID | INACCESSIBLE_ENCRYPTION_CREDS | INACCESSIBLE_SECRET_ARN | INACCESSIBLE_VPC_ENDPOINT | INCOMPATIBLE_NETWORK | MERGING | MODIFYING | SPLITTING | COPYING | STARTING | STOPPING | STOPPED | MAINTENANCE | INACCESSIBLE_ENCRYPTION_CREDENTIALS_RECOVERABLE`   
필수 여부: 예

 ** subnetIds **   <a name="documentdb-Type-elastic_Cluster-subnetIds"></a>
탄력적 클러스터의 Amazon EC2 서브넷 ID입니다.  
유형: 문자열 배열  
필수 여부: 예

 ** vpcSecurityGroupIds **   <a name="documentdb-Type-elastic_Cluster-vpcSecurityGroupIds"></a>
탄력적 클러스터와 연결된 EC2 VPC 보안 그룹 목록입니다.  
유형: 문자열 배열  
필수 여부: 예

 ** backupRetentionPeriod **   <a name="documentdb-Type-elastic_Cluster-backupRetentionPeriod"></a>
자동 스냅샷이 보관되는 일수입니다.  
유형: Integer  
필수 여부: 아니요

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

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

 ** shards **   <a name="documentdb-Type-elastic_Cluster-shards"></a>
클러스터의 샤드 총 개수입니다.  
타입: [Shard](API_elastic_Shard.md)객체 배열  
필수 여부: 아니요

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

언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/Cluster) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/Cluster) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/Cluster)