MongoDBMongoDB Atlas Administration API v2
POST/api/atlas/v2/groups/{groupId}/clusters
Manage create Group Cluster.
Contract-preserving POST endpoint for create Group Cluster in the MongoDB Atlas Administration API. Resource-specific values are supplied by the caller at runtime.
All 540 MongoDB Atlas administration endpoints from a fixed Apache-2.0 OpenAPI revision. Hub provides documentation and an independent SDK/CLI, but never proxies account, organization, project, network, backup, or operational data; callers connect directly with local credentials.
Request
- operationId
createGroupCluster- Server
https://cloud.mongodb.com- Authentication
- ServiceAccounts, DigestAuth
Request parameters
envelope
queryboolean
envelope value in the Atlas Administration API contract.
groupId
pathstringrequired
group Id value in the Atlas Administration API contract.
32b6e34b3d91647abb20e7b8
pretty
queryboolean
pretty value in the Atlas Administration API contract.
Use-Effective-Instance-Fields
headerboolean
Use Effective Instance Fields value in the Atlas Administration API contract.
Use-Effective-Fields-Replication-Specs
headerboolean
Use Effective Fields Replication Specs value in the Atlas Administration API contract.
Request body
LegacyAtlasClusterrequired
Content-Type: application/vnd.atlas.2023-01-01+json, application/vnd.atlas.2023-02-01+json, application/vnd.atlas.2024-08-05+json, application/vnd.atlas.2024-10-23+json
Properties: acceptDataRisksAndForceReplicaSetReconfigadvancedConfigurationautoScalingbackupEnabledbiConnectorclusterTypeconfigServerManagementModeconfigServerTypeconnectionStringscreateDatedeleteAfterCreationHoursdeleteAfterDatediskSizeGBdiskWarmingModeencryptionAtRestProviderfeatureCompatibilityVersionfeatureCompatibilityVersionExpirationDateglobalClusterSelfManagedShardinggroupIdidlabelslinksmongoDBEmployeeAccessGrantmongoDBMajorVersionmongoDBVersionmongoURImongoURIUpdatedmongoURIWithOptionsnamenumShardspausedpitEnabledproviderBackupEnabledproviderSettingsreplicaSetScalingStrategyreplicationFactorreplicationSpecreplicationSpecsrootCertTypesrvAddressstateNametagsterminationProtectionEnabledversionReleaseSystem
Responses
201
LegacyAtlasClusterapplication/vnd.atlas.2023-01-01+jsonapplication/vnd.atlas.2023-02-01+jsonapplication/vnd.atlas.2024-08-05+jsonapplication/vnd.atlas.2024-10-23+json
Successful supplier response.
Properties: acceptDataRisksAndForceReplicaSetReconfigadvancedConfigurationautoScalingbackupEnabledbiConnectorclusterTypeconfigServerManagementModeconfigServerTypeconnectionStringscreateDatedeleteAfterCreationHoursdeleteAfterDatediskSizeGBdiskWarmingModeencryptionAtRestProviderfeatureCompatibilityVersionfeatureCompatibilityVersionExpirationDateglobalClusterSelfManagedShardinggroupIdidlabelslinksmongoDBEmployeeAccessGrantmongoDBMajorVersionmongoDBVersionmongoURImongoURIUpdatedmongoURIWithOptionsnamenumShardspausedpitEnabledproviderBackupEnabledproviderSettingsreplicaSetScalingStrategyreplicationFactorreplicationSpecreplicationSpecsrootCertTypesrvAddressstateNametagsterminationProtectionEnabledversionReleaseSystem
400
ApiErrorapplication/json
Supplier response with HTTP status 400.
Properties: badRequestDetaildetailerrorerrorCodeparametersreason
401
ApiErrorapplication/json
Supplier response with HTTP status 401.
Properties: badRequestDetaildetailerrorerrorCodeparametersreason
402
ApiErrorapplication/json
Supplier response with HTTP status 402.
Properties: badRequestDetaildetailerrorerrorCodeparametersreason
403
ApiErrorapplication/json
Supplier response with HTTP status 403.
Properties: badRequestDetaildetailerrorerrorCodeparametersreason
404
ApiErrorapplication/json
Supplier response with HTTP status 404.
Properties: badRequestDetaildetailerrorerrorCodeparametersreason
409
ApiErrorapplication/json
Supplier response with HTTP status 409.
Properties: badRequestDetaildetailerrorerrorCodeparametersreason
429
ApiErrorapplication/json
Supplier response with HTTP status 429.
Properties: badRequestDetaildetailerrorerrorCodeparametersreason
500
ApiErrorapplication/json
Supplier response with HTTP status 500.
Properties: badRequestDetaildetailerrorerrorCodeparametersreason
{
"advancedConfiguration": {
"customOpensslCipherConfigTls12": [
"TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384"
],
"customOpensslCipherConfigTls13": [
"TLS_AES_256_GCM_SHA384"
],
"minimumEnabledTlsProtocol": "TLS1_0",
"tlsCipherConfigMode": "CUSTOM"
},
"autoScaling": {
"compute": {
"enabled": false,
"scaleDownEnabled": false
},
"diskGBEnabled": false
},
"backupEnabled": false,
"biConnector": {
"enabled": false,
"readPreference": "PRIMARY"
},
"clusterType": "REPLICASET",
"configServerManagementMode": "ATLAS_MANAGED",
"configServerType": "DEDICATED"
}