지정된 프로젝트에 클러스터를 한 개 생성합니다. 클러스터에는 동일한 데이터 세트를 유지하는 호스팅 그룹이 포함되어 있습니다. 이 리소스는 멀티 클라우드 클러스터를 생성할 수 있습니다. 각 프로젝트는 최대 25개의 데이터베이스 배포를 지원합니다. 이 기능은 서버리스 클러스터에서는 사용할 수 없습니다.
M2 또는 M5 의 instanceSize 를 사용하면 대신 Flex 클러스터 생성됩니다. M2 또는 M5 의 instanceSize 에 대한 지원이 2026 1월에 중단됩니다. 앞으로 이러한 구성을 위해서는 Create Flex Cluster API 사용하는 것이 좋습니다.
프로젝트 식별하는 고유한 24-16진수 문자열입니다. 인증된 사용자가 액세스 할 수 있는 모든 프로젝트를 조회 하려면 /groups 엔드포인트를 사용합니다.
참고: 그룹과 프로젝트는 동의어입니다. 그룹 ID는 프로젝트 ID와 동일합니다. 기존 그룹의 경우, 그룹/프로젝트 ID는 동일하게 유지됩니다. 리소스 및 해당 엔드포인트는 그룹이라는 용어를 사용합니다.
형식은 ^([a-f0-9]{24})$ 패턴 과 일치해야 합니다.
애플리케이션이 응답을 envelope JSON 객체로 래핑할지 여부를 나타내는 플래그입니다. 일부 API 클라이언트는 HTTP 응답 헤더 또는 상태 코드에 액세스할 수 없습니다. 이 문제를 해결하려면 쿼리에서 envelope=true를 설정합니다. 결과 목록을 반환하는 엔드포인트는 결과 객체를 엔벨로프로 사용합니다. 애플리케이션은 응답 본문에 상태 매개변수를 추가합니다.
기본값은 false 입니다.
응답 본문이 프리티프린트 형식이어야 하는지 여부를 나타내는 플래그입니다.
기본값은 false 입니다.
이 프로젝트에서 생성할 클러스터입니다.
리전 장애로 인해 프라이머리 프라이머리 복구하기 위해 재구성이 필요한 경우 토폴로지 재구성과 함께 이 필드 제출 새로운 리전 장애 방지 토폴로지 요청 . 투표 선택 가능 노드 대부분이 장애된 상태에서 강제로 재구성하면 복제된 쓰기 (write)(과반수의 커밋된 쓰기 포함)가 새 프라이머리 노드 에 복제되지 않은 경우 데이터가 손실될 위험이 있습니다. MongoDB Atlas docs에 자세한 내용이 포함되어 있습니다. 이러한 위험을 수반하는 작업을 계속 진행하려면 acceptDataRisksAndForceReplicaSetReconfig 을(를) 현재 날짜로 설정하다 . 이 매개변수는 UTC의 ISO 8601 타임스탬프 형식으로 값을 표현합니다.
고급 구성 세부 사항의 하위 집합을 구성하는 설정 그룹입니다.
클러스터 백업을 수행할 수 있는지 여부를 나타내는 플래그입니다. true로 설정하다 클러스터 백업을 수행할 수 있습니다. NVMe 클러스터의 경우 이 값을 true 로 설정하다 해야 합니다. 백업은 전용 클러스터에는 클라우드 백업 을 사용하고 테넌트 클러스터에는 공유 클러스터 백업 을 사용합니다. false로 설정하다 클러스터 백업을 사용하지 않습니다.
기본값은 false 입니다.
이 클러스터에 대한 Business Intelligence용 MongoDB Connector를 구성하는 데 필요한 설정입니다.
클러스터를 구성하는 노드의 구성.
값은 REPLICASET, SHARDED 또는 GEOSHARDED입니다.
샤딩된 클러스터 생성하거나 업데이트하기 위한 Config 서버 관리 모드입니다. ATLAS_MANAGED으로 구성된 경우, Atlas 최적의 성능과 비용 절감을 위해 클러스터의 config 서버 유형을 자동으로 전환할 수 있습니다. FIXED_TO_DEDICATED(으)로 구성하면 클러스터 항상 전용 config 서버 사용합니다.
값은 ATLAS_MANAGED 또는 FIXED_TO_DEDICATED입니다. 기본값은 ATLAS_MANAGED입니다.
인스턴스 데이터 볼륨의 스토리지 용량은 기가바이트 단위로 표현됩니다. 용량을 추가하려면 이 숫자를 늘리세요.
이 값은 M0/M2/M5 클러스터에서 구성할 수 없습니다.
replicationSpecs를 설정하다 경우 MongoDB 클라우드에 이 매개 변수가 필요합니다.
디스크 크기를 최소값(10GB) 미만으로 지정하면 이 매개변수는 기본값인 최소 디스크 크기 값으로 설정됩니다.
스토리지 요금은 기본값을 선택하는지, 아니면 사용자 지정 값을 선택하는지에 따라 다르게 계산됩니다.
선택한 클러스터의 최대 RAM의 50배를 초과할 수 없습니다. 더 많은 저장 공간이 필요한 경우 클러스터를 더 높은 티어로 업그레이드하는 것이 좋습니다.
디스크 보온 모드 선택.
값은 FULLY_WARMED 또는 VISIBLE_EARLIER입니다. 기본값은 FULLY_WARMED입니다.
클러스터 에 추가 미사용 데이터 암호화 계층을 제공하기 위해 고객 키를 관리하는 클라우드 서비스 제공자 . 미사용 데이터 암호화 위한 고객 키 관리 활성화 하려면 클러스터 replicationSpecs[n].regionConfigs[m].{type}Specs.instanceSize 설정을 M10 이상으로 설정하고 "backupEnabled" : false 또는 완전히 생략해야 합니다.
값은 NONE, AWS, AZURE 또는 GCP입니다.
새 글로벌 클러스터를 생성할 때 샤딩 관리 모드를 구성하려면 이 필드를 설정합니다.
false로 설정하면 관리 모드가 Atlas 관리 샤딩으로 설정됩니다. 이 모드는 글로벌 클러스터의 샤딩을 완벽하게 관리하며 원활한 배포 환경을 제공하도록 구축되었습니다.
true로 설정하면 관리 모드가 자체 관리 샤딩으로 설정됩니다. 이 모드는 샤드 관리를 사용자에게 맡기며 유연한 고급 배포 환경을 제공하도록 설계되었습니다.
클러스터가 배포된 후에는 이 설정을 변경할 수 없습니다.
클러스터에 태그를 지정하고 분류하는 1~255자 길이의 키-값 쌍 컬렉션. MongoDB Cloud 콘솔에는 레이블이 표시되지 않습니다.
클러스터 레이블은 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다. 대신 리소스 태그를 사용할 것을 적극 권장합니다.
클러스터의 MongoDB 주요 버전입니다.
생성 시: 사용 가능한 MongoDB 버전 중에서 선택하거나 현재 권장되는 기본값을 지정하지 않고 그대로 두어 MongoDB 클라우드 플랫폼에서 사용할 수 있습니다. 권장되는 버전은 최신 LTS(장기 지원) 버전입니다. 기본값은 전체 릴리스 주기 동안 가장 최근에 릴리스된 버전으로 보장되지 않습니다. 특정 프로젝트에서 사용할 수 있는 버전을 알아보려면 링크된 문서를 참조하거나 프로젝트 LTS 버전 엔드포인트에 대한 API 엔드포인트를 사용하세요.
업데이트 시: 한 번에 1개의 주요 버전만 버전을 증가시킵니다. 클러스터가 현재 MongoDB 버전보다 정확히 한 주요 버전 낮은 MongoDB 기능 호환성 버전에 고정되어 있는 경우, MongoDB 버전을 이전 주요 버전으로 다운그레이드할 수 있습니다.
고급 클러스터를 식별하는 인간 판독 가능 레이블.
형식은 ^[a-zA-Z0-9][a-zA-Z0-9-]*$ 패턴 과 일치해야 합니다.
클러스터의 일시 중지 여부를 나타내는 플래그.
클러스터의 지속적인 클라우드 백업 사용 여부를 나타내는 플래그.
이 필드를 설정하여 클러스터의 복제본 세트 스케일링 모드를 구성합니다.
기본값 으로 Atlas WORKLOAD_TYPE 미만으로 확장됩니다. 이 모드 사용하면 Atlas 운영 노드와 병렬로 분석 노드를 확장하다 할 수 있습니다.
SEQUENTIAL로 구성하면 Atlas 모든 노드를 순차적으로 확장합니다. 이 모드 지연 시간에 민감한 세컨더리 읽기를 수행하는 정상 상태 워크로드 및 애플리케이션을 위한 것입니다.
NODE_TYPE로 구성하면 Atlas 투표 선택 가능 노드를 읽기 전용 및 분석 노드와 병렬로 확장합니다. 이 모드 빈번하고 시기적절한 클러스터 계층 확장 필요한 대규모 동적 워크로드를 위한 모드입니다. 이는 가장 빠른 확장 전략이지만 광범위한 세컨더리 읽기를 수행할 때 워크로드 지연 시간 영향 수 있습니다.
값은 SEQUENTIAL, WORKLOAD_TYPE 또는 NODE_TYPE입니다. 기본값은 WORKLOAD_TYPE입니다.
클러스터 리전을 구성하는 설정 목록. 글로벌 클러스터의 경우 배열의 각 객체는 클러스터 노드 배포 영역을 나타냅니다. 글로벌이 아닌 샤딩된 클러스터 및 복제본 세트의 경우 이 배열에는 클러스터 노드 배포 위치를 나타내는 객체가 하나 포함됩니다.
MongoDB Atlas cluster 사용하는 루트 인증 기관. MongoDB Cloud는 Internet Security Research Group을 지원합니다.
값은 ISRGROOTX1입니다. 기본값은 ISRGROOTX1입니다.
클러스터의 종료 보호 활성화 여부를 나타내는 플래그. true로 설정하면 MongoDB Cloud가 클러스터를 삭제하지 않습니다. false로 설정하면 MongoDB Cloud가 클러스터를 삭제합니다.
기본값은 false 입니다.
클러스터 MongoDB 버전을 유지 관리하는 방법입니다. 값이 CONTINUOUS인 경우 mongoDBMajorVersion를 지정하지 않아야 합니다.
값은 LTS 또는 CONTINUOUS입니다. 기본값은 LTS입니다.
curl \
--request POST 'https://cloud.mongodb.com/api/atlas/v1.5/groups/32b6e34b3d91647abb20e7b8/clusters' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"clusterType": "REPLICASET",
"links": [],
"name": "multiCloud",
"replicationSpecs": [
{
"numShards": 1,
"regionConfigs": [
{
"analyticsAutoScaling": {
"autoIndexing": {
"enabled": false
},
"compute": {
"enabled": true,
"maxInstanceSize": "M40",
"minInstanceSize": "M30",
"scaleDownEnabled": true
},
"diskGB": {
"enabled": true
}
},
"analyticsSpecs": {
"instanceSize": "M30",
"nodeCount": 0
},
"autoScaling": {
"autoIndexing": {
"enabled": false
},
"compute": {
"enabled": true,
"maxInstanceSize": "M40",
"minInstanceSize": "M30",
"scaleDownEnabled": true
},
"diskGB": {
"enabled": true
}
},
"electableSpecs": {
"instanceSize": "M30",
"nodeCount": 3
},
"hiddenSecondarySpecs": {
"instanceSize": "M30",
"nodeCount": 0
},
"priority": 7,
"providerName": "AWS",
"readOnlySpecs": {
"instanceSize": "M30",
"nodeCount": 0
},
"regionName": "US_EAST_1"
},
{
"analyticsAutoScaling": {
"autoIndexing": {
"enabled": false
},
"compute": {
"enabled": true,
"maxInstanceSize": "M40",
"minInstanceSize": "M30",
"scaleDownEnabled": true
},
"diskGB": {
"enabled": true
}
},
"analyticsSpecs": {
"instanceSize": "M30",
"nodeCount": 0
},
"autoScaling": {
"autoIndexing": {
"enabled": false
},
"compute": {
"enabled": true,
"maxInstanceSize": "M40",
"minInstanceSize": "M30",
"scaleDownEnabled": true
},
"diskGB": {
"enabled": true
}
},
"electableSpecs": {
"instanceSize": "M30",
"nodeCount": 2
},
"hiddenSecondarySpecs": {
"instanceSize": "M30",
"nodeCount": 0
},
"priority": 6,
"providerName": "GCP",
"readOnlySpecs": {
"instanceSize": "M30",
"nodeCount": 0
},
"regionName": "EASTERN_US"
}
],
"zoneName": "Zone 1"
}
]
}'{
"clusterType": "REPLICASET",
"links": [],
"name": "multiCloud",
"replicationSpecs": [
{
"numShards": 1,
"regionConfigs": [
{
"analyticsAutoScaling": {
"autoIndexing": {
"enabled": false
},
"compute": {
"enabled": true,
"maxInstanceSize": "M40",
"minInstanceSize": "M30",
"scaleDownEnabled": true
},
"diskGB": {
"enabled": true
}
},
"analyticsSpecs": {
"instanceSize": "M30",
"nodeCount": 0
},
"autoScaling": {
"autoIndexing": {
"enabled": false
},
"compute": {
"enabled": true,
"maxInstanceSize": "M40",
"minInstanceSize": "M30",
"scaleDownEnabled": true
},
"diskGB": {
"enabled": true
}
},
"electableSpecs": {
"instanceSize": "M30",
"nodeCount": 3
},
"hiddenSecondarySpecs": {
"instanceSize": "M30",
"nodeCount": 0
},
"priority": 7,
"providerName": "AWS",
"readOnlySpecs": {
"instanceSize": "M30",
"nodeCount": 0
},
"regionName": "US_EAST_1"
},
{
"analyticsAutoScaling": {
"autoIndexing": {
"enabled": false
},
"compute": {
"enabled": true,
"maxInstanceSize": "M40",
"minInstanceSize": "M30",
"scaleDownEnabled": true
},
"diskGB": {
"enabled": true
}
},
"analyticsSpecs": {
"instanceSize": "M30",
"nodeCount": 0
},
"autoScaling": {
"autoIndexing": {
"enabled": false
},
"compute": {
"enabled": true,
"maxInstanceSize": "M40",
"minInstanceSize": "M30",
"scaleDownEnabled": true
},
"diskGB": {
"enabled": true
}
},
"electableSpecs": {
"instanceSize": "M30",
"nodeCount": 2
},
"hiddenSecondarySpecs": {
"instanceSize": "M30",
"nodeCount": 0
},
"priority": 6,
"providerName": "GCP",
"readOnlySpecs": {
"instanceSize": "M30",
"nodeCount": 0
},
"regionName": "EASTERN_US"
}
],
"zoneName": "Zone 1"
}
]
}{
"acceptDataRisksAndForceReplicaSetReconfig": "2026-05-04T09:42:00Z",
"advancedConfiguration": {
"customOpensslCipherConfigTls12": [
"TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384"
],
"customOpensslCipherConfigTls13": [
"TLS_AES_256_GCM_SHA384"
],
"minimumEnabledTlsProtocol": "TLS1_2",
"tlsCipherConfigMode": "CUSTOM"
},
"backupEnabled": false,
"biConnector": {
"enabled": true,
"readPreference": "PRIMARY"
},
"clusterType": "REPLICASET",
"configServerManagementMode": "ATLAS_MANAGED",
"configServerType": "DEDICATED",
"connectionStrings": {
"awsPrivateLink": {
"additionalProperty1": "string",
"additionalProperty2": "string"
},
"awsPrivateLinkSrv": {
"additionalProperty1": "string",
"additionalProperty2": "string"
},
"private": "string",
"privateEndpoint": [
{
"connectionString": "string",
"endpoints": [
{
"endpointId": "string",
"providerName": "AWS",
"region": "string"
}
],
"srvConnectionString": "string",
"srvShardOptimizedConnectionString": "string",
"type": "MONGOD"
}
],
"privateSrv": "string",
"standard": "string",
"standardSrv": "string"
},
"createDate": "2026-05-04T09:42:00Z",
"diskSizeGB": 42.0,
"diskWarmingMode": "FULLY_WARMED",
"encryptionAtRestProvider": "NONE",
"featureCompatibilityVersion": "string",
"featureCompatibilityVersionExpirationDate": "2026-05-04T09:42:00Z",
"globalClusterSelfManagedSharding": true,
"groupId": "32b6e34b3d91647abb20e7b8",
"id": "32b6e34b3d91647abb20e7b8",
"labels": [
{
"key": "string",
"value": "string"
}
],
"links": [
{
"href": "https://cloud.mongodb.com/api/atlas",
"rel": "self"
}
],
"mongoDBEmployeeAccessGrant": {
"expirationTime": "2026-05-04T09:42:00Z",
"grantType": "CLUSTER_DATABASE_LOGS",
"links": [
{
"href": "https://cloud.mongodb.com/api/atlas",
"rel": "self"
}
]
},
"mongoDBMajorVersion": "string",
"mongoDBVersion": "string",
"name": "string",
"paused": true,
"pitEnabled": true,
"replicaSetScalingStrategy": "WORKLOAD_TYPE",
"replicationSpecs": [
{
"id": "32b6e34b3d91647abb20e7b8",
"numShards": 42,
"regionConfigs": [
{}
],
"zoneId": "32b6e34b3d91647abb20e7b8",
"zoneName": "string"
}
],
"rootCertType": "ISRGROOTX1",
"stateName": "IDLE",
"tags": [
{
"key": "string",
"value": "string"
}
],
"terminationProtectionEnabled": false,
"versionReleaseSystem": "LTS"
}{
"detail": "(This is just an example, the exception may not be related to this endpoint) No provider AWS exists.",
"error": 400,
"errorCode": "VALIDATION_ERROR",
"reason": "Bad Request"
}{
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"error": 401,
"errorCode": "NOT_ORG_GROUP_CREATOR",
"reason": "Unauthorized"
}{
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"error": 402,
"errorCode": "NO_PAYMENT_INFORMATION_FOUND",
"reason": "Payment Required"
}{
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"error": 403,
"errorCode": "CANNOT_CHANGE_GROUP_NAME",
"reason": "Forbidden"
}{
"detail": "(This is just an example, the exception may not be related to this endpoint) Cannot find resource AWS",
"error": 404,
"errorCode": "RESOURCE_NOT_FOUND",
"reason": "Not Found"
}{
"detail": "(This is just an example, the exception may not be related to this endpoint) Cannot delete organization link while there is active migration in following project ids: 60c4fd418ebe251047c50554",
"error": 409,
"errorCode": "CANNOT_DELETE_ORG_ACTIVE_LIVE_MIGRATION_ATLAS_ORG_LINK",
"reason": "Conflict"
}{
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"error": 500,
"errorCode": "UNEXPECTED_ERROR",
"reason": "Internal Server Error"
}