Crea un clúster en el proyecto específico. Los clústeres contienen un grupo de hosts que mantienen el mismo conjunto de datos. Este recurso no crea clústeres multi-nube. Para crear un clúster multinube, usa "Crear un clúster avanzado".
Cuando implementas un clúster dedicado M10+, Atlas crea una VPC para el proveedor y les región o regiones seleccionadpmaschineos si no existe una VPC existente o una conexión de emparejamiento de VPC para ese proveedor y región. Atlas asigna al VPC un bloque de direccionamiento sin clase entre dominios (CIDR).
Ten en cuenta que el uso de un instanceSize de M2 o M5 creará un clúster flexible en su lugar. Se suspenderá el soporte para la instanceSize de M2 o M5 el 22 de enero de 2026. Recomendamos utilizar la API Create Flex clúster para tales configuraciones en el futuro.
- Propietario del proyecto
Parámetros de path
-
string única de 24dígitos hexadecimales que identifica tu proyecto. Usa el endpoint /groups para recuperar todos los proyectos a los que el usuario autenticado tiene acceso.
NOTA: Grupos y proyectos son términos sinónimos. El id de tu grupo es el mismo que el id de tu proyecto. Para los grupos ya existentes, el id de su grupo/proyecto sigue siendo el mismo. El recurso y los endpoints correspondientes utilizan el término grupos.
El formato debe coincidir con el siguiente patrón:
^([a-f0-9]{24})$.
Parámetros de query
-
Bandera que indica si la aplicación envuelve la respuesta en un objeto JSON
envelope. Algunos clientes de la API no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para remediar esto, establece envelope=true en la query. Los endpoints que devuelven una lista de resultados utilizan el objeto de resultados como un sobre. La aplicación agrega el parámetro de estado al cuerpo de la respuesta.El valor por defecto es
false. -
Bandera que indica si el cuerpo de la respuesta debe estar en el formato prettyprint.
El valor por defecto es
false.pretty-print
Cuerpo
Requerido
Clúster para crear en este Proyecto.
-
Si se requiere una reconfiguración para recuperar un primario debido a una interrupción regional, envía este campo junto con tu reconfiguración de topología para solicitar una nueva topología resistente a interrupciones regionales. Las reconfiguraciones forzadas durante una interrupción de la mayoría de los nodos elegibles conllevan un riesgo de pérdida de datos si las escrituras replicadas (incluso las escrituras comprometidas por la mayoría) no se han replicado en el nuevo nodo primario. Los Docs de MongoDB Atlas contienen más información. Para proceder con una operación que conlleva ese riesgo, establecer
acceptDataRisksAndForceReplicaSetReconfiga la fecha actual. Este parámetro expresa su valor en el formato de timestamp ISO 8601 en UTC.Reconfiguración de un set de réplicas du... -
Grupo de ajustes que configura un subconjunto de los detalles avanzados de configuración.
-
Rango de tamaños de instancias a los que tu clúster puede escalar.
Escalado automático de clúster -
Indicador que señala si el clúster puede realizar copias de seguridad. Si se establece en
true, el clúster puede realizar copias de seguridad. Debe establecer este valor entruepara clústeres NVMe. La copia de seguridad utiliza Copias de seguridad en la nube para clústeres dedicados y Copias de seguridad de clústeres compartidos para clústeres de inquilinos. Si se establece enfalse, el clúster no utiliza copias de seguridad en la nube de MongoDB. -
Configuraciones necesarias para configurar el MongoDB Connector for Business Intelligence para este clúster.
MongoDB Connector para negocios... -
Configuración de los nodos que componen el clúster.
Los valores son
REPLICASET,SHARDEDoGEOSHARDED. -
Modo de gestión del servidor de configuración para crear o actualizar un clúster. Cuando está configurado como
ATLAS_MANAGED, Atlas puede cambiar automáticamente el tipo de servidor de configuración del clúster para un rendimiento y ahorro óptimos. Cuando está configurado comoFIXED_TO_DEDICATED, el clúster siempre usará un servidor de configuración dedicado.Los valores son
ATLAS_MANAGEDoFIXED_TO_DEDICATED. El valor por defecto esATLAS_MANAGED.Configuración del clúster compartido de MongoDB... -
Número de horas después de la creación del clúster tras el cual este clúster se borrará automáticamente.
Este campo se utiliza para derivar
deleteAfterDateen relación concreateDate.Cuando se establezca en nulo o cero al crear el clúster, este no se borrará automáticamente.
Cuando se establece en un valor positivo al crear el clúster, este se borrará automáticamente después del número especificado de horas.
Al actualizar este campo en un clúster existente (que no se ha eliminado), y si esto se configura como nulo, entonces los valores existentes se conservarán para esto y
deleteAfterDate.Al actualizar este campo en un clúster existente (no eliminado), y si se establece en cero, entonces
deleteAfterDatese restablece a nulo (desactivar el borrado automático) independientemente de las configuraciones previas.Al actualizar este campo en un clúster existente (no eliminado), y si se establece un valor positivo, entonces
createDate+deleteAfterCreationHoursdebe ser posterior a ahora; si no se cumple esta condición, la actualización del campo se ignora y se preservan los valores existentes para este &deleteAfterDate. -
Capacidad de almacenamiento de los volúmenes de datos de instancia expresada en gigabytes. Aumenta este número para añadir capacidad.
Este valor no se puede configurar en los clústeres M0/M2/M5.
MongoDB Cloud requiere este parámetro si configuras
replicationSpecs.Si se especifica un tamaño de disco inferior al mínimo (10 GB), este parámetro se ajusta por defecto al valor mínimo de tamaño de disco.
Los cálculos del cargo por almacenamiento dependen de si eliges el valor por defecto o un valor personalizado.
El valor máximo del almacenamiento en disco no puede exceder 50 veces la RAM máxima para el clúster seleccionado. Si necesita más espacio de almacenamiento, considera actualizar su clúster a un nivel superior.
El valor mínimo es
10, el valor máximo es4096. -
Selección de modo de calentamiento de disco.
Los valores son
FULLY_WARMEDoVISIBLE_EARLIER. El valor por defecto esFULLY_WARMED.Reducir el calentamiento del disco secundario ... -
Proveedor de servicios en la nube que gestiona las claves de los clientes para proporcionar una capa adicional de cifrado en reposo para el clúster. Para habilitar la gestión de claves de cliente para el cifrado en reposo, la configuración del clúster
replicationSpecs[n].regionConfigs[m].{type}Specs.instanceSizedebe serM10o superior y"backupEnabled" : falseo quedar completamente omitida.Los valores son
NONE,AWS,AZUREoGCP.Cifrado en reposo mediante Custo... -
Establezca este campo para configurar el Modo de gestión de particionado al crear un nuevo clúster global.
Cuando está configurado en falso, el modo de gestión se establece en Atlas-Gestionado Particionado. Este modo gestiona completamente el particionado de su clúster global y está diseñado para proporcionar una experiencia de implementación sin interrupciones.
Cuando se configura como true, el modo de gestión se establece en particionado autogestionado. Este modo deja la gestión de particiones en tus manos y está construido para proporcionar una experiencia de implementación avanzada y flexible.
Este ajuste no puede modificarse una vez que el clúster esté desplegado.
Crear un clúster global -
Colección de pares clave-valor, entre 1 y 255 caracteres de longitud, que etiquetan y categorizan el clúster. La consola de MongoDB nube no muestra tus etiquetas.
Las etiquetas de clúster están obsoletas y se eliminarán en una futura actualización. Recomendamos encarecidamente que utilices etiquetas de recursos en su lugar.
Resource Tags -
Versión principal de MongoDB del clúster.
Al crear: Elige entre las versiones disponibles de MongoDB o deja el campo sin especificar para usar la versión por defecto en la plataforma MongoDB Nube. La versión recomendada es una versión reciente de soporte a largo plazo. No se garantiza que la versión por defecto sea la más recientemente publicada durante todo el ciclo de lanzamiento. Para obtener información sobre las versiones disponibles en un proyecto específico, consulta la documentación vinculada o utiliza el endpoint de la API para el endpoint de versiones LTS del proyecto.
Al actualizar: aumente la versión solo en 1 versión principal a la vez. Si el clúster está fijado a una versión de compatibilidad de características entre versiones de MongoDB exactamente una versión principal por debajo de la versión actual de MongoDB, la versión de MongoDB se puede degradar a la versión principal anterior.
Versiones de MongoDB disponibles en... -
Versión de MongoDB que ejecuta el clúster.
El formato debe coincidir con el siguiente patrón:
([\d]+\.[\d]+\.[\d]+). -
Etiqueta legible por humanos que identifica el clúster.
El formato debe coincidir con el siguiente patrón:
^[a-zA-Z0-9][a-zA-Z0-9-]*$. -
Número de particiones de hasta 50 para implementar en un clúster. El recurso devuelve
1para indicar un set de réplicas y valores de2o superiores para indicar un clúster. El valor devuelto es igual al número de particiones en el clúster.El valor mínimo es
1, el valor máximo es50. El valor por defecto es1.particionado -
Indicador que señala si el clúster está pausado.
-
Indicador que señala si el clúster utiliza copias de seguridad en la nube.
Copias de seguridad continuas en la nube -
Bandera que indica si el clúster M10 o superior puede realizar copias de seguridad en la nube. Si se establece en
true, el clúster puede realizar copias de seguridad. Si esta ybackupEnabledestán configuradas enfalse, el clúster no utiliza copias de seguridad de MongoDB Cloud. -
Configura este campo para configurar el modo de escalado del set de réplicas para tu clúster.
Por defecto, Atlas escala bajo
WORKLOAD_TYPE. Este modo permite que Atlas escale tus nodos de análisis en paralelo a tus nodos operacionales.Cuando está configurado como
SEQUENTIAL, Atlas escala todos los nodos secuencialmente. Este modo está destinado a cargas de trabajo en estado estable y aplicaciones que realizan lecturas secundarias que son sensibles a la latencia.Cuando se configura como
NODE_TYPE, Atlas escala sus nodos elegibles en paralelo con sus nodos de solo lectura y de análisis. Este modo está diseñado para cargas de trabajo voluminosas y dinámicas que requieren un escalado frecuente y oportuno del nivel de clúster. Esta es la estrategia de escalado más rápida, pero podría impactar la latencia de las cargas de trabajo al realizar extensas lecturas secundarias.Los valores son
SEQUENTIAL,WORKLOAD_TYPEoNODE_TYPE. El valor por defecto esWORKLOAD_TYPE.Modificar el escalado del set de réplicas... -
Número de nodos que pertenecen al set de réplicas. Cada nodo conserva una copia de tus bases de datos, proporcionando alta disponibilidad y redundancia de datos. Usa
replicationSpecsen su lugar.Los valores son
3,5o7. El valor por defecto es3. -
Ubicación física donde MongoDB nube aprovisiona nodos de clúster.
-
Lista de configuraciones que configuran las regiones de su clúster.
- Para los clústeres globales, cada objeto en el arreglo representa una zona en la que MongoDB Cloud implementa los nodos de tus clústeres.
- Para clústeres shard no globales y sets de réplicas, el único objeto representa dónde MongoDB Cloud implementa los nodos de tus clústeres.
-
Autoridad Certificadora Raíz que utiliza el clúster de MongoDB Atlas. MongoDB nube apoya al Internet seguridad Research Group.
El valor es
ISRGROOTX1. El valor por defecto esISRGROOTX1. -
Indicador que señala si la protección contra terminación está activada en el clúster. Si configurado en
true, MongoDB Nube no borrará el clúster. Si se establece enfalse, MongoDB Cloud borrará el clúster.El valor por defecto es
false. -
Método por el cual el clúster mantiene las versiones de MongoDB. Si el valor es
CONTINUOUS, no debe especificarmongoDBMajorVersion.Los valores son
LTSoCONTINUOUS. El valor por defecto esLTS.
curl \
--request POST 'https://cloud.mongodb.com/api/atlas/v1.0/groups/32b6e34b3d91647abb20e7b8/clusters' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{"acceptDataRisksAndForceReplicaSetReconfig":"2026-05-04T09:42:00Z","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":true,"biConnector":{"enabled":true,"readPreference":"PRIMARY"},"clusterType":"REPLICASET","configServerManagementMode":"ATLAS_MANAGED","deleteAfterCreationHours":42,"diskSizeGB":42.0,"diskWarmingMode":"FULLY_WARMED","encryptionAtRestProvider":"NONE","globalClusterSelfManagedSharding":true,"labels":[{"key":"string","value":"string"}],"mongoDBMajorVersion":"5.0","mongoDBVersion":"5.0.25","name":"string","numShards":1,"paused":true,"pitEnabled":true,"providerBackupEnabled":true,"providerSettings":{"providerName":"AWS","autoScaling":{"compute":{"maxInstanceSize":"M10","minInstanceSize":"M10"}},"diskIOPS":42,"encryptEBSVolume":true,"instanceSizeName":"M10","regionName":"US_GOV_WEST_1","volumeType":"STANDARD"},"replicaSetScalingStrategy":"WORKLOAD_TYPE","replicationFactor":3,"replicationSpec":{"additionalProperty1":{"analyticsNodes":42,"electableNodes":0,"priority":42,"readOnlyNodes":42},"additionalProperty2":{"analyticsNodes":42,"electableNodes":0,"priority":42,"readOnlyNodes":42}},"replicationSpecs":[{"id":"32b6e34b3d91647abb20e7b8","numShards":1,"regionsConfig":{"additionalProperty1":{"analyticsNodes":42,"electableNodes":0,"priority":42,"readOnlyNodes":42},"additionalProperty2":{"analyticsNodes":42,"electableNodes":0,"priority":42,"readOnlyNodes":42}},"zoneName":"string"}],"rootCertType":"ISRGROOTX1","tags":[{"key":"string","value":"string"}],"terminationProtectionEnabled":false,"versionReleaseSystem":"LTS"}'{
"acceptDataRisksAndForceReplicaSetReconfig": "2026-05-04T09:42:00Z",
"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": true,
"biConnector": {
"enabled": true,
"readPreference": "PRIMARY"
},
"clusterType": "REPLICASET",
"configServerManagementMode": "ATLAS_MANAGED",
"deleteAfterCreationHours": 42,
"diskSizeGB": 42.0,
"diskWarmingMode": "FULLY_WARMED",
"encryptionAtRestProvider": "NONE",
"globalClusterSelfManagedSharding": true,
"labels": [
{
"key": "string",
"value": "string"
}
],
"mongoDBMajorVersion": "5.0",
"mongoDBVersion": "5.0.25",
"name": "string",
"numShards": 1,
"paused": true,
"pitEnabled": true,
"providerBackupEnabled": true,
"providerSettings": {
"providerName": "AWS",
"autoScaling": {
"compute": {
"maxInstanceSize": "M10",
"minInstanceSize": "M10"
}
},
"diskIOPS": 42,
"encryptEBSVolume": true,
"instanceSizeName": "M10",
"regionName": "US_GOV_WEST_1",
"volumeType": "STANDARD"
},
"replicaSetScalingStrategy": "WORKLOAD_TYPE",
"replicationFactor": 3,
"replicationSpec": {
"additionalProperty1": {
"analyticsNodes": 42,
"electableNodes": 0,
"priority": 42,
"readOnlyNodes": 42
},
"additionalProperty2": {
"analyticsNodes": 42,
"electableNodes": 0,
"priority": 42,
"readOnlyNodes": 42
}
},
"replicationSpecs": [
{
"id": "32b6e34b3d91647abb20e7b8",
"numShards": 1,
"regionsConfig": {
"additionalProperty1": {
"analyticsNodes": 42,
"electableNodes": 0,
"priority": 42,
"readOnlyNodes": 42
},
"additionalProperty2": {
"analyticsNodes": 42,
"electableNodes": 0,
"priority": 42,
"readOnlyNodes": 42
}
},
"zoneName": "string"
}
],
"rootCertType": "ISRGROOTX1",
"tags": [
{
"key": "string",
"value": "string"
}
],
"terminationProtectionEnabled": false,
"versionReleaseSystem": "LTS"
}{
"acceptDataRisksAndForceReplicaSetReconfig": "2026-05-04T09:42:00Z",
"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": true,
"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",
"deleteAfterCreationHours": 42,
"deleteAfterDate": "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": "5.0",
"mongoDBVersion": "5.0.25",
"mongoURI": "string",
"mongoURIUpdated": "2026-05-04T09:42:00Z",
"mongoURIWithOptions": "string",
"name": "string",
"numShards": 1,
"paused": true,
"pitEnabled": true,
"providerBackupEnabled": true,
"providerSettings": {
"providerName": "AWS",
"autoScaling": {
"compute": {
"maxInstanceSize": "M10",
"minInstanceSize": "M10"
}
},
"diskIOPS": 42,
"encryptEBSVolume": true,
"instanceSizeName": "M10",
"regionName": "US_GOV_WEST_1",
"volumeType": "STANDARD"
},
"replicaSetScalingStrategy": "WORKLOAD_TYPE",
"replicationFactor": 3,
"replicationSpec": {
"additionalProperty1": {
"analyticsNodes": 42,
"electableNodes": 0,
"priority": 42,
"readOnlyNodes": 42
},
"additionalProperty2": {
"analyticsNodes": 42,
"electableNodes": 0,
"priority": 42,
"readOnlyNodes": 42
}
},
"replicationSpecs": [
{
"id": "32b6e34b3d91647abb20e7b8",
"numShards": 1,
"regionsConfig": {
"additionalProperty1": {
"analyticsNodes": 42,
"electableNodes": 0,
"priority": 42,
"readOnlyNodes": 42
},
"additionalProperty2": {
"analyticsNodes": 42,
"electableNodes": 0,
"priority": 42,
"readOnlyNodes": 42
}
},
"zoneName": "string"
}
],
"rootCertType": "ISRGROOTX1",
"srvAddress": "string",
"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"
}