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 multinube. Para crear un clúster multinube, utilice "Crear un clúster avanzado". Para usar este recurso, la cuenta de servicio o la clave API solicitantes deben tener el rol de propietario del proyecto.
Al implementar un clúster dedicado M10+, Atlas crea una VPC para el proveedor y la región seleccionados si no existe ninguna VPC ni conexión de emparejamiento de VPC para dicho proveedor y región. Atlas asigna a la VPC un bloque de enrutamiento entre dominios sin clases (CIDR).
Tenga en cuenta que usar un instanceSize de M2 o M5 creará un clúster Flex. La compatibilidad con el instanceSize de M2 o M5 se suspenderá el 22 de enero de 2026. Recomendamos usar la API "Crear clúster Flex" para estas configuraciones de ahora en adelante.
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.Impresión bonita
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 conjunto de réplicas... -
Grupo de ajustes que configura un subconjunto de los detalles avanzados de configuración.
-
Rango de tamaños de instancias a los que puede escalar su clúster.
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, el clúster se eliminará automáticamente después de la cantidad de horas especificada.
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 se establece en cero, entonces
deleteAfterDatese restablece a nulo (deshabilita la eliminación automática) independientemente de las configuraciones anteriores.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 es configurable en clústeres M0/M2/M5.
MongoDB Cloud requiere este parámetro si configura
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... -
Configure este campo para configurar el modo de administración de fragmentación 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.
Esta configuración no se puede cambiar una vez implementado el clúster.
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 del clúster MongoDB.
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 predeterminado es1.particionado -
Indicador que señala si el clúster está pausado.
-
Bandera que indica si el clúster utiliza copias de seguridad en la nube continuas.
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. -
Configure este campo para configurar el modo de escalamiento del conjunto de réplicas para su 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 predeterminado esWORKLOAD_TYPE.Modificar el escalado del set de réplicas... -
Número de miembros que pertenecen al conjunto de réplicas. Cada miembro conserva una copia de sus bases de datos, lo que proporciona alta disponibilidad y redundancia de datos. Utilice
replicationSpecsen su lugar.Los valores son
3,5o7. El valor predeterminado 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 de certificación raíz que utiliza el clúster MongoDB Atlas. MongoDB Cloud apoya al Grupo de Investigación de Seguridad en Internet.
El valor es
ISRGROOTX1. El valor por defecto esISRGROOTX1. -
Indicador que indica si la protección contra la terminación está habilitada en el clúster. Si se establece en
true, MongoDB Cloud no eliminará el clúster. Si se establece enfalse, MongoDB Cloud eliminará 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"
}{
"error": 400,
"detail": "(This is just an example, the exception may not be related to this endpoint) No provider AWS exists.",
"reason": "Bad Request",
"errorCode": "VALIDATION_ERROR"
}{
"error": 401,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Unauthorized",
"errorCode": "NOT_ORG_GROUP_CREATOR"
}{
"error": 402,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Payment Required",
"errorCode": "NO_PAYMENT_INFORMATION_FOUND"
}{
"error": 403,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Forbidden",
"errorCode": "CANNOT_CHANGE_GROUP_NAME"
}{
"error": 404,
"detail": "(This is just an example, the exception may not be related to this endpoint) Cannot find resource AWS",
"reason": "Not Found",
"errorCode": "RESOURCE_NOT_FOUND"
}{
"error": 409,
"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",
"reason": "Conflict",
"errorCode": "CANNOT_DELETE_ORG_ACTIVE_LIVE_MIGRATION_ATLAS_ORG_LINK"
}{
"error": 500,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Internal Server Error",
"errorCode": "UNEXPECTED_ERROR"
}