Devuelve los detalles de todos los clústeres en el proyecto específico al que tienes acceso. Los clústeres contienen un grupo de hosts que mantienen el mismo conjunto de datos. La respuesta no incluye clústeres multi-nube. Para devolver clústeres multi-nube, utilice Obtener todos los clústeres avanzados.
Este endpoint también puede utilizarse en clústeres Flex que se hayan creado mediante el endpoint Crear clúster o en antiguos clústeres M2/M5 que se hayan migrado a clústeres Flex hasta el 2026 de enero. Por favor, utiliza el endpoint List Flex Clusters para los clústeres Flex.
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})$.
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 MongoDB nube calcula el número total de elementos para la respuesta. Cuando se establece en false, MongoDB Cloud puede omitir una operación de recuento adicional. La respuesta aún puede incluir totalCount cuando el recuento esté disponible sin cálculos adicionales.
El valor por defecto es true.
Número de elementos que la respuesta retorna por página.
El valor mínimo es 1, el valor máximo es 500. El valor por defecto es 100.
Número de la página que muestra el conjunto actual del total de objetos que devuelve la respuesta.
El valor mínimo es 1. El valor por defecto es 1.
Bandera que indica si el cuerpo de la respuesta debe estar en el formato prettyprint.
El valor por defecto es false.
Indicador que señala si se deben devolver los clústeres con copias de seguridad retenidas.
El valor por defecto es false.
OK
Lista de uno o más uniform resource locators (URL) que apuntan a subrecursos de API, recursos API relacionados o ambos. RFC 5988 describe estas relaciones.
Localizador uniforme de recursos (URL) que señala otro recurso de la API con el que esta respuesta guarda relación. Esta URL suele comenzar con https://cloud.mongodb.com/api/atlas.
Localizador Uniforme de Recursos (URL) que define la relación semántica entre este recurso y otro recurso de la API. Esta URL suele comenzar con https://cloud.mongodb.com/api/atlas.
Lista de documentos devueltos que MongoDB nube proporciona al completar esta solicitud.
Grupo de configuraciones que configuran un clúster de MongoDB.
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 acceptDataRisksAndForceReplicaSetReconfig a la fecha actual. Este parámetro expresa su valor en el formato de timestamp ISO 8601 en UTC.
Grupo de ajustes que configura un subconjunto de los detalles avanzados de configuración.
La lista personalizada de conjuntos de cifrado de OpenSSL para TLS 1.2. Requiere tlsCipherConfigMode = CUSTOM; cuando se omite tlsCipherConfigMode, proporcionar una lista no vacía infiere CUSTOM.
Los valores son TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 o TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256.
La lista personalizada de conjuntos de cifrado de OpenSSL para TLS 1.3. Requiere tlsCipherConfigMode = CUSTOM; cuando se omite tlsCipherConfigMode, proporcionar una lista no vacía infiere CUSTOM.
No más de 4 elementos. Los valores son TLS_AES_256_GCM_SHA384, TLS_CHACHA20_POLY1305_SHA256, TLS_AES_128_GCM_SHA256 o TLS_AES_128_CCM_SHA256.
Versión mínima de Transport Layer Security (TLS) que el clúster acepta para conexiones entrantes.
Los valores son TLS1_2 o TLS1_3.
El modo de configuración del conjunto de cifrado TLS. El modo por defecto utiliza los conjuntos de cifrado por defecto. El modo personalizado le permite especificar conjuntos de cifrado personalizados tanto para TLS 1.2 como para TLS 1.3.
Los valores son CUSTOM o DEFAULT.
Rango de tamaños de instancias a los que tu clúster puede escalar.
Colección de configuraciones que configura cómo un clúster podría escalar su nivel de clúster y si el clúster puede escalar hacia abajo. El escalado automático del nivel del clúster no está disponible para clústeres que utilizan clases de almacenamiento de baja CPU o almacenamiento NVMe.
Bandera que indica si el escalado automático reactivo del tamaño de la instancia está habilitado.
true para habilitar el escalado automático reactivo del tamaño de instancia. Si está habilitado, debe especificar un valor para providerSettings.autoScaling.compute.maxInstanceSize.false para desactivar el escalado automático reactivo del tamaño de la instancia.El valor por defecto es false.
Indicador que indica si el nivel de clúster puede escalar hacia abajo mediante escalado automático reactivo. Esto es necesario si autoScaling.compute.enabled es true. Si habilitas esta opción, especifica un valor para providerSettings.autoScaling.compute.minInstanceSize.
El valor por defecto es false.
Indicador que señala si alguien habilitó el escalado automático de disco para este clúster.
El valor por defecto es false.
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 en true para 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 en false, 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.
Indicador que señala si el Connector de MongoDB para Business Intelligence está activo en el clúster especificado.
Nodo fuente de datos designado para el MongoDB Connector for Business Intelligence en MongoDB nube. El MongoDB Connector for Business Intelligence en MongoDB Cloud lee datos desde el nodo principal, secundario o de análisis según tus preferencias de lectura. Por defecto en el nodo ANALYTICS, o en SECONDARY si no hay nodos ANALYTICS.
Los valores son PRIMARY, SECONDARY o ANALYTICS.
Configuración de los nodos que componen el clúster.
Los valores son REPLICASET, SHARDED o GEOSHARDED.
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 como FIXED_TO_DEDICATED, el clúster siempre usará un servidor de configuración dedicado.
Los valores son ATLAS_MANAGED o FIXED_TO_DEDICATED. El valor por defecto es ATLAS_MANAGED.
Describe el tipo de servidor de configuración de un clúster particionado.
Los valores son DEDICATED o EMBEDDED.
Colección de localizadores de recursos uniformes que apuntan a la base de datos MongoDB.
Obsoleto: Utilice el recurso de cadenas de conexión de punto final privado en su lugar. Cadenas de conexión conscientes de endpoints privados que utilizan clústeres alojados por AWS con Amazon Web Services (AWS) PrivateLink. Cada clave identifica un punto final de interfaz de Amazon Web Services (AWS). Cada valor identifica la cadena de conexión mongodb:// relacionada que utilizas para conectarte a MongoDB Cloud a través del endpoint de interfaz que nombra la clave.
Obsoleto: Utilice el recurso de cadenas de conexión de punto final privado en su lugar. Cadenas de conexión conscientes de endpoints privados que utilizan clústeres alojados por AWS con Amazon Web Services (AWS) PrivateLink. Cada clave identifica un punto final de interfaz de Amazon Web Services (AWS). Cada valor identifica la cadena de conexión mongodb:// relacionada que utilizas para conectarte a MongoDB Cloud a través del endpoint de interfaz que nombra la clave.
Obsoleto: Utilice el recurso de cadenas de conexión de punto final privado en su lugar. Cadenas de conexión conscientes de endpoints privados que utilizan clústeres alojados por AWS con Amazon Web Services (AWS) PrivateLink. Cada clave identifica un punto final de interfaz de Amazon Web Services (AWS). Cada valor identifica la cadena de conexión relacionada mongodb:// que utilizas para conectarte a Atlas a través del endpoint de interfaz que nombran las claves. Si el clúster utiliza una cadena de conexión optimizada, awsPrivateLinkSrv contiene la cadena de conexión optimizada. Si el clúster tiene la cadena de conexión no optimizada (heredada), awsPrivateLinkSrv contiene la cadena de conexión no optimizada incluso si también hay una cadena de conexión optimizada.
Obsoleto: Utilice el recurso de cadenas de conexión de punto final privado en su lugar. Cadenas de conexión conscientes de endpoints privados que utilizan clústeres alojados por AWS con Amazon Web Services (AWS) PrivateLink. Cada clave identifica un punto final de interfaz de Amazon Web Services (AWS). Cada valor identifica la cadena de conexión relacionada mongodb:// que utilizas para conectarte a Atlas a través del endpoint de interfaz que nombran las claves. Si el clúster utiliza una cadena de conexión optimizada, awsPrivateLinkSrv contiene la cadena de conexión optimizada. Si el clúster tiene la cadena de conexión no optimizada (heredada), awsPrivateLinkSrv contiene la cadena de conexión no optimizada incluso si también hay una cadena de conexión optimizada.
Cadenas de conexión peering de red para cada interfaz Punto de Interfaz de Virtual Private Cloud (VPC) que has configurado para conectarte a este clúster. Esta cadena de conexión utiliza el protocolo mongodb+srv://. El recurso entrega este parámetro una vez que alguien crea una conexión peering de red a este clúster. Este protocolo indica a la aplicación que busque la lista de nodos iniciales del host en el Sistema de Nombres de Dominio (DNS). Esta lista se sincroniza con los nodos en un clúster. Si la cadena de conexión utiliza este formato de identificador uniforme de recursos (URI), no necesitas agregar la lista de nodos iniciales ni cambiar el URI si los nodos cambian. Utiliza este formato de URI si tu driver es compatible. Si no es así, usa connectionStrings.private. Para los clústeres de Amazon Web Services (AWS), este recurso solo devuelve este parámetro si habilitas DNS personalizado.
Obsoleto: Utilice el recurso de cadenas de conexión de endpoint privado en su lugar. Lista de cadenas de conexión conscientes de endpoints privados que puede usar para conectarse a este clúster a través de un endpoint privado. Este parámetro solo se devuelve si ha desplegado un endpoint privado en todas las regiones en las que ha desplegado los nodos de este clúster.
Cadena de conexión consciente de nodos privados que puedes usar para conectarte a este clúster a través de un nodo privado.
Cadena de conexión consciente de la terminal privada que utiliza el protocolo mongodb:// para conectar con MongoDB nube a través de una terminal privada.
Lista que contiene los nodos privados a través de los cuales te conectas a MongoDB nube cuando usas connectionStrings.privateEndpoint[n].connectionString o connectionStrings.privateEndpoint[n].srvConnectionString.
Detalles de un endpoint privado implementado para este clúster.
string única que el proveedor de nube utiliza para identificar el endpoint privado.
El proveedor de nube en el cual MongoDB Cloud implementa el endpoint privado.
Los valores son AWS, AZURE o GCP.
Región donde se implementa el endpoint privado.
Cadena de conexión consciente de un endpoint privado que utiliza el protocolo mongodb+srv:// para conectarse a MongoDB Cloud a través de un endpoint privado. El mongodb+srv protocolo indica al driver que busque la lista de nodos iniciales de hosts en el sistema de nombres de dominio (DNS). Esta lista se sincroniza con los nodos en un clúster. Si la cadena de conexión utiliza este formato de Identificador Uniforme de Recursos (URI), no necesita agregar la lista de nodos iniciales ni cambiar el Identificador Uniforme de Recursos (URI) si cambian los nodos. Usa este formato de Identificador Uniforme de Recursos (URI) si tu aplicación lo admite. Si no es así, usa connectionStrings.privateEndpoint[n].connectionString.
Cadena de conexión optimizada para clústeres particionados con terminal privado que utiliza el protocolo mongodb+srv:// para conectarse a MongoDB Cloud a través de un terminal privado. Si la cadena de conexión utiliza este formato de identificador uniforme de recursos (URI), no necesitas cambiar el identificador uniforme de recursos (URI) si los nodos cambian. Utiliza este formato de Uniform Resource Identifier (URI) si tu aplicación y el clúster de Atlas lo admiten. Si no lo hace, utiliza y consulta la documentación de connectionStrings.privateEndpoint[n].srvConnectionString.
Tipo de proceso MongoDB al que se conecta su aplicación. Utilice MONGOD para los sets de réplicas y MONGOS para los clústeres.
Los valores son MONGOD o MONGOS.
Cadenas de conexión peering de red para cada uno de los endpoints de Virtual Private Cloud (VPC) de interfaz que configuraste para conectarte a este clúster. Esta cadena de conexión utiliza el protocolo mongodb+srv://. El recurso devuelve este parámetro cuando alguien crea una conexión peering de red a este clúster. Este protocolo indica a la aplicación que busque la lista de nodos iniciales de host en el Sistema de Nombres de Dominio (DNS). Esta lista se sincroniza con los nodos en un clúster. Si la cadena de conexión utiliza este formato de Identificador Uniforme de Recursos (URI), no es necesario agregar la lista de nodos iniciales ni cambiar el Identificador Uniforme de Recursos (URI) si los nodos cambian. Use este formato de Identificador Uniforme de Recursos (URI) si su controlador lo admite. Si no lo hace, utiliza connectionStrings.private. Para clústeres de Amazon Web Services (AWS), este parámetro sólo se devuelve si Activa DNS personalizada.
Cadena de conexión pública que puede usar para conectarse a este clúster. Esta cadena de conexión utiliza el protocolo mongodb://.
Cadena de conexión pública que puede usar para conectarse a este clúster. Esta cadena de conexión utiliza el protocolo mongodb+srv://.
Fecha y hora en que MongoDB Cloud creó esta instancia sin servidor. MongoDB nube representa esta marca de tiempo en formato ISO 8601 en UTC.
Disponible en vista previa pública: Campo opcional que indica si su clúster será Atlas INFINITE o CORE. Este campo se aplica solo a clústeres flexibles y compartidos. Solo puede configurarlo cuando cree el clúster o cuando actualice un clúster flexible a un clúster dedicado. Este valor es inmutable una vez que el clúster dedicado existe; intentar cambiarlo en una solicitud de actualizar devuelve un error.
Los valores son CORE o INFINITE.
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 deleteAfterDate en relación con createDate.
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 deleteAfterDate se 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 + deleteAfterCreationHours debe 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.
La fecha en la que este clúster será eliminado automáticamente.
Este parámetro expresa su valor en el formato de marca de tiempo ISO 8601 en UTC y se deriva en base a createDate + deleteAfterCreationHours.
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 es 4096.
Selección de modo de calentamiento de disco.
Los valores son FULLY_WARMED o VISIBLE_EARLIER. El valor por defecto es FULLY_WARMED.
Disponible en vista previa pública: Campo que representa si su clúster es Atlas INFINITE o CORE. Este campo se aplica solo a clústeres flexibles y compartidos. Esto es de solo lectura y siempre se devuelve en la respuesta. Refleja el estado real del clúster. Este valor coincide con databaseEdition si se configuró; de lo contrario, refleja la edición de base de datos por defecto asignada al clúster.
Los valores son CORE o INFINITE.
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.instanceSize debe ser M10 o superior y "backupEnabled" : false o quedar completamente omitida.
Los valores son NONE, AWS, AZURE o GCP.
Compatibilidad de características entre versiones del clúster.
Fecha de expiración de la compatibilidad de características entre versiones. Este parámetro expresa su valor en el formato de timestamp ISO 8601 en UTC.
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.
string única de caracteres hexadecimales de 24que identifica el proyecto.
El formato debe coincidir con el siguiente patrón: ^([a-f0-9]{24})$.
string única de 24dígitos hexadecimales que identifica el clúster.
El formato debe coincidir con el siguiente patrón: ^([a-f0-9]{24})$.
Obsoleto: Las etiquetas de clúster se eliminarán en una versión futura. Recomendamos encarecidamente que utilice etiquetas de recursos en su lugar.
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.
Etiquetas legibles para humanos aplicadas a este componente de MongoDB Cloud.
Clave aplicada para etiquetar y categorizar este componente.
La longitud mínima es de 1, la longitud máxima es de 255.
Valor establecido a la Llave aplicada para etiquetar y categorizar este componente.
La longitud mínima es de 1, la longitud máxima es de 255.
Lista de uno o más uniform resource locators (URL) que apuntan a subrecursos de API, recursos API relacionados o ambos. RFC 5988 describe estas relaciones.
Localizador uniforme de recursos (URL) que señala otro recurso de la API con el que esta respuesta guarda relación. Esta URL suele comenzar con https://cloud.mongodb.com/api/atlas.
Localizador Uniforme de Recursos (URL) que define la relación semántica entre este recurso y otro recurso de la API. Esta URL suele comenzar con https://cloud.mongodb.com/api/atlas.
Empleado de MongoDB concedió el nivel de acceso y la expiración para un clúster.
Fecha de vencimiento para la concesión de acceso del empleado. Este parámetro expresa su valor en el formato de timestamp ISO 8601 en UTC.
Nivel de acceso que se concede a los Empleados de MongoDB.
Los valores son CLUSTER_DATABASE_LOGS, CLUSTER_INFRASTRUCTURE o CLUSTER_INFRASTRUCTURE_AND_APP_SERVICES_SYNC_DATA.
Lista de uno o más uniform resource locators (URL) que apuntan a subrecursos de API, recursos API relacionados o ambos. RFC 5988 describe estas relaciones.
Localizador uniforme de recursos (URL) que señala otro recurso de la API con el que esta respuesta guarda relación. Esta URL suele comenzar con https://cloud.mongodb.com/api/atlas.
Localizador Uniforme de Recursos (URL) que define la relación semántica entre este recurso y otro recurso de la API. Esta URL suele comenzar con https://cloud.mongodb.com/api/atlas.
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.
Versión de MongoDB que ejecuta el clúster.
El formato debe coincidir con el siguiente patrón: ([\d]+\.[\d]+\.[\d]+).
Cadena de conexión base que puedes usar para conectarte al clúster. MongoDB Cloud muestra el string sólo después de que el clúster se inicia, no mientras se construye el clúster.
Fecha y hora en que alguien actualizó por última vez la cadena de conexión. MongoDB nube representa esta marca de tiempo en formato ISO 8601 en UTC.
Cadena de conexión que puede usar para conectarse al clúster, incluyendo los parámetros de consulta replicaSet, ssl y authSource con valores adecuados para el clúster. Es posible que deba agregar usuarios de base de datos MongoDB. La respuesta devuelve este parámetro una vez que el clúster pueda recibir solicitudes, no mientras se está construyendo el clúster.
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 1 para indicar un set de réplicas y valores de 2 o 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 es 50. El valor por defecto es 1.
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.
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 y backupEnabled están configuradas en false, el clúster no utiliza copias de seguridad de MongoDB Cloud.
Grupo de configuraciones del proveedor de nube que configuran los hosts de MongoDB provisionados.
El valor es AWS.
Rango de tamaños de instancias a los que tu clúster puede escalar.
Colección de configuraciones que configura cómo un clúster podría escalar su nivel de clúster y si el clúster puede escalar hacia abajo. El escalado automático del nivel del clúster no está disponible para clústeres que utilizan clases de almacenamiento de baja CPU o almacenamiento NVMe.
El tamaño máximo de instancia al que el clúster puede escalar automáticamente.
Los valores son M10, M20, M30, M40, M50, M60, M80, M100, M140, M200, M300, R40, R50, R60, R80, R200, R300, R400, R700, M40_NVME, M50_NVME, M60_NVME, M80_NVME, M200_NVME, M400_NVME, M30_GEN_2, M40_GEN_2, M50_GEN_2, M60_GEN_2, M80_GEN_2, M140_GEN_2, M200_GEN_2, M300_GEN_2, M700_GEN_2, R40_GEN_2, R50_GEN_2, R60_GEN_2, R80_GEN_2, R200_GEN_2, R300_GEN_2, R400_GEN_2, R700_GEN_2, M40_NVME_GEN_2, M50_NVME_GEN_2, M60_NVME_GEN_2, M80_NVME_GEN_2, M200_NVME_GEN_2, o M400_NVME_GEN_2.
Tamaño mínimo de instancia al cual tu clúster puede escalar automáticamente.
Los valores son M10, M20, M30, M40, M50, M60, M80, M100, M140, M200, M300, R40, R50, R60, R80, R200, R300, R400, R700, M40_NVME, M50_NVME, M60_NVME, M80_NVME, M200_NVME, M400_NVME, M30_GEN_2, M40_GEN_2, M50_GEN_2, M60_GEN_2, M80_GEN_2, M140_GEN_2, M200_GEN_2, M300_GEN_2, M700_GEN_2, R40_GEN_2, R50_GEN_2, R60_GEN_2, R80_GEN_2, R200_GEN_2, R300_GEN_2, R400_GEN_2, R700_GEN_2, M40_NVME_GEN_2, M50_NVME_GEN_2, M60_NVME_GEN_2, M80_NVME_GEN_2, M200_NVME_GEN_2, o M400_NVME_GEN_2.
Máximo de operaciones de entrada/salida por segundo en disco (IOPS) que el host de la base de datos puede realizar.
Obsoleto: Indicador que indica si la función de cifrado Amazon Elastic Block Store (EBS) cifra el volumen raíz del host tanto para los datos en reposo dentro del volumen como para los datos que se mueven entre el volumen y el clúster. Los clústeres siempre tienen esta configuración activada.
El valor por defecto es true.
Nivel de clúster, con una capacidad predeterminada de almacenamiento y memoria que se aplica a todos los hosts que almacenan datos en su clúster.
Los valores son M10, M20, M30, M40, M50, M60, M80, M100, M140, M200, M300, R40, R50, R60, R80, R200, R300, R400, R700, M40_NVME, M50_NVME, M60_NVME, M80_NVME, M200_NVME, M400_NVME, M30_GEN_2, M40_GEN_2, M50_GEN_2, M60_GEN_2, M80_GEN_2, M140_GEN_2, M200_GEN_2, M300_GEN_2, M700_GEN_2, R40_GEN_2, R50_GEN_2, R60_GEN_2, R80_GEN_2, R200_GEN_2, R300_GEN_2, R400_GEN_2, R700_GEN_2, M40_NVME_GEN_2, M50_NVME_GEN_2, M60_NVME_GEN_2, M80_NVME_GEN_2, M200_NVME_GEN_2, o M400_NVME_GEN_2.
Ubicación física donde MongoDB nube implementa los nodos del clúster de MongoDB alojados en AWS. La región que elijas puede afectar la latencia de red para los clientes que acceden a sus bases de datos. Cuando MongoDB Cloud implementa un clúster dedicado, verifica si existe un VPC o una conexión VPC para ese proveedor y región. Si no existe, MongoDB nube los crea como parte de la implementación. MongoDB nube asigna al VPC un bloque CIDR. Para limitar una nueva conexión de emparejamiento de VPC a un solo bloque CIDR y región, primero cree la conexión. Implementa el clúster una vez iniciada la conexión.
Los valores son US_GOV_WEST_1, US_GOV_EAST_1, US_EAST_1, US_EAST_2, US_WEST_1, US_WEST_2, CA_CENTRAL_1, EU_NORTH_1, EU_WEST_1, EU_WEST_2, EU_WEST_3, EU_CENTRAL_1, EU_CENTRAL_2, AP_EAST_1, AP_EAST_2, AP_NORTHEAST_1, AP_NORTHEAST_2, AP_NORTHEAST_3, AP_SOUTHEAST_1, AP_SOUTHEAST_2, AP_SOUTHEAST_3, AP_SOUTHEAST_4, AP_SOUTHEAST_5, AP_SOUTHEAST_6, AP_SOUTHEAST_7, AP_SOUTH_1, AP_SOUTH_2, SA_EAST_1, CN_NORTH_1, CN_NORTHWEST_1, ME_SOUTH_1, ME_CENTRAL_1, AF_SOUTH_1, EU_SOUTH_1, EU_SOUTH_2, IL_CENTRAL_1, CA_WEST_1, MX_CENTRAL_1 o GLOBAL.
Configuración de operaciones por segundo (IOPS) de disco para el almacenamiento de Amazon Web Services (AWS) que se configura sólo para AWS. Especifica si las operaciones de entrada/salida por segundo (IOPS) del disco no deben exceder la tasa por defecto de Operaciones de entrada/salida por segundo (IOPS) para el tamaño de volumen seleccionado (STANDARD), o si deben estar dentro del rango permitido de Operaciones de entrada/salida por segundo (IOPS) para el tamaño de volumen seleccionado (PROVISIONED o HIGH_PERFORMANCE). Los clústeres NVMe requieren ya sea PROVISIONED o HIGH_PERFORMANCE.
Los valores son STANDARD, PROVISIONED o HIGH_PERFORMANCE.
Grupo de configuraciones del proveedor de nube que configuran los hosts de MongoDB provisionados.
El valor es AZURE.
Rango de tamaños de instancias a los que tu clúster puede escalar.
Colección de configuraciones que configura cómo un clúster podría escalar su nivel de clúster y si el clúster puede escalar hacia abajo. El escalado automático del nivel del clúster no está disponible para clústeres que utilizan clases de almacenamiento de baja CPU o almacenamiento NVMe.
El tamaño máximo de instancia al que el clúster puede escalar automáticamente.
Los valores son M10, M20, M30, M40, M50, M60, M80, M90, M200, R40, R50, R60, R80, R200, R300, R400, M60_NVME, M80_NVME, M200_NVME, M300_NVME, M400_NVME o M600_NVME.
Tamaño mínimo de instancia al cual tu clúster puede escalar automáticamente.
Los valores son M10, M20, M30, M40, M50, M60, M80, M90, M200, R40, R50, R60, R80, R200, R300, R400, M60_NVME, M80_NVME, M200_NVME, M300_NVME, M400_NVME o M600_NVME.
Tipo de disco que corresponde al volumen raíz del host para las instancias de Azure. Si se omite, aplica el tipo de disco por defecto para el providerSettings.instanceSizeName seleccionado.
Los valores son P2, P3, P4, P6, P10, P15, P20, P30, P40 o P50.
Nivel de clúster, con una capacidad predeterminada de almacenamiento y memoria que se aplica a todos los hosts que almacenan datos en su clúster.
Los valores son M10, M20, M30, M40, M50, M60, M80, M90, M200, R40, R50, R60, R80, R200, R300, R400, M60_NVME, M80_NVME, M200_NVME, M300_NVME, M400_NVME o M600_NVME.
Regiones de Microsoft Azure.
Los valores son US_CENTRAL, US_EAST, US_EAST_2, US_NORTH_CENTRAL, US_WEST, US_SOUTH_CENTRAL, EUROPE_NORTH, EUROPE_WEST, US_WEST_CENTRAL, US_WEST_2, US_WEST_3, CANADA_EAST, CANADA_CENTRAL, BRAZIL_SOUTH, BRAZIL_SOUTHEAST, AUSTRALIA_CENTRAL, AUSTRALIA_CENTRAL_2, AUSTRALIA_EAST, AUSTRALIA_SOUTH_EAST, GERMANY_WEST_CENTRAL, GERMANY_NORTH, SWEDEN_CENTRAL, SWEDEN_SOUTH, SWITZERLAND_NORTH, SWITZERLAND_WEST, UK_SOUTH, UK_WEST, NORWAY_EAST, NORWAY_WEST, INDIA_CENTRAL, INDIA_SOUTH, INDIA_WEST, CHINA_EAST, CHINA_NORTH, ASIA_EAST, JAPAN_EAST, JAPAN_WEST, ASIA_SOUTH_EAST, KOREA_CENTRAL, KOREA_SOUTH, FRANCE_CENTRAL, FRANCE_SOUTH, SOUTH_AFRICA_NORTH, SOUTH_AFRICA_WEST, UAE_CENTRAL, UAE_NORTH, QATAR_CENTRAL, POLAND_CENTRAL, ISRAEL_CENTRAL, ITALY_NORTH, SPAIN_CENTRAL, MEXICO_CENTRAL, NEW_ZEALAND_NORTH, US_GOV_VIRGINIA, US_GOV_ARIZONA o US_GOV_TEXAS.
Grupo de configuraciones del proveedor de nube que configuran los hosts de MongoDB provisionados.
El valor es GCP.
Rango de tamaños de instancias a los que tu clúster puede escalar.
Colección de configuraciones que configura cómo un clúster podría escalar su nivel de clúster y si el clúster puede escalar hacia abajo. El escalado automático del nivel del clúster no está disponible para clústeres que utilizan clases de almacenamiento de baja CPU o almacenamiento NVMe.
El tamaño máximo de instancia al que el clúster puede escalar automáticamente.
Los valores son M10, M20, M30, M40, M50, M60, M80, M140, M200, M250, M300, M400, R40, R50, R60, R80, R200, R300, R400, R600, M30_GEN_2, M40_GEN_2, M50_GEN_2, M60_GEN_2, M80_GEN_2, M140_GEN_2, M200_GEN_2, M300_GEN_2, M700_GEN_2, R40_GEN_2, R50_GEN_2, R60_GEN_2, R80_GEN_2, R200_GEN_2, R300_GEN_2 o R400_GEN_2.
Tamaño mínimo de instancia al cual tu clúster puede escalar automáticamente.
Los valores son M10, M20, M30, M40, M50, M60, M80, M140, M200, M250, M300, M400, R40, R50, R60, R80, R200, R300, R400, R600, M30_GEN_2, M40_GEN_2, M50_GEN_2, M60_GEN_2, M80_GEN_2, M140_GEN_2, M200_GEN_2, M300_GEN_2, M700_GEN_2, R40_GEN_2, R50_GEN_2, R60_GEN_2, R80_GEN_2, R200_GEN_2, R300_GEN_2 o R400_GEN_2.
Nivel de clúster, con una capacidad predeterminada de almacenamiento y memoria que se aplica a todos los hosts que almacenan datos en su clúster.
Los valores son M10, M20, M30, M40, M50, M60, M80, M140, M200, M250, M300, M400, R40, R50, R60, R80, R200, R300, R400, R600, M30_GEN_2, M40_GEN_2, M50_GEN_2, M60_GEN_2, M80_GEN_2, M140_GEN_2, M200_GEN_2, M300_GEN_2, M700_GEN_2, R40_GEN_2, R50_GEN_2, R60_GEN_2, R80_GEN_2, R200_GEN_2, R300_GEN_2 o R400_GEN_2.
Regiones de Google Compute.
Los valores son EASTERN_US, EASTERN_US_AW, US_EAST_4, US_EAST_4_AW, US_EAST_5, US_EAST_5_AW, US_WEST_2, US_WEST_2_AW, US_WEST_3, US_WEST_3_AW, US_WEST_4, US_WEST_4_AW, US_SOUTH_1, US_SOUTH_1_AW, CENTRAL_US, CENTRAL_US_AW, WESTERN_US, WESTERN_US_AW, NORTH_AMERICA_NORTHEAST_1, NORTH_AMERICA_NORTHEAST_2, NORTH_AMERICA_SOUTH_1, SOUTH_AMERICA_EAST_1, SOUTH_AMERICA_WEST_1, WESTERN_EUROPE, EUROPE_NORTH_1, EUROPE_WEST_2, EUROPE_WEST_3, EUROPE_WEST_4, EUROPE_WEST_6, EUROPE_WEST_8, EUROPE_WEST_9, EUROPE_WEST_10, EUROPE_WEST_12, EUROPE_SOUTHWEST_1, EUROPE_CENTRAL_2, MIDDLE_EAST_CENTRAL_1, MIDDLE_EAST_CENTRAL_2, MIDDLE_EAST_WEST_1, AUSTRALIA_SOUTHEAST_1, AUSTRALIA_SOUTHEAST_2, AFRICA_SOUTH_1, EASTERN_ASIA_PACIFIC, NORTHEASTERN_ASIA_PACIFIC, SOUTHEASTERN_ASIA_PACIFIC, ASIA_EAST_2, ASIA_NORTHEAST_2, ASIA_NORTHEAST_3, ASIA_SOUTH_1, ASIA_SOUTH_2 o ASIA_SOUTHEAST_2.
Grupo de configuraciones del proveedor de nube que configuran los hosts de MongoDB provisionados.
El valor es TENANT.
Rango de tamaños de instancias a los que tu clúster puede escalar.
Colección de configuraciones que determina cómo un clúster puede escalar su nivel de clúster y si el clúster puede reducirse para escalar.
Proveedor de servicios en la nube en el que MongoDB Cloud aprovisionó el host multicliente. El recurso retorna este parámetro cuando providerSettings.providerName es TENANT y providerSetting.instanceSizeName es M0, M2 o M5.
Tenga en cuenta que usar un instanceSize de M2 o M5 creará, en cambio, un clúster Flex. El soporte para la instanceSize de M2 o M5 se descontinuará en enero de 2026. Recomendamos utilizar la API de creación de clúster flexible para este tipo de configuraciones a futuro.
Los valores son AWS, GCP o AZURE.
El tamaño real de la instancia del inquilino. Esto está presente para soportar la compatibilidad hacia atrás para tipos de proveedor obsoletos y/o tamaños de instancia.
Los valores son FLEX, M2, M5 o M0.
nivel de clúster, con una capacidad de almacenamiento y memoria por defecto, que se aplica a todos los hosts que contienen datos en tu clúster. Debe configurar providerSettings.providerName en TENANT e indicar el proveedor de servicios en la nube en providerSettings.backingProviderName.
Los valores son M0, M2 o M5.
Etiqueta legible por humanos que identifica la ubicación geográfica de su clúster de MongoDB. La región que elija puede afectar la latencia de la red para los clientes que acceden a sus bases de datos. Para ver una lista completa de nombres de regiones, consulta AWS, GCP y Azure. Para clústeres multirregionales, consulte replicationSpec.{region}.
Grupo de configuraciones del proveedor de nube que configuran los hosts de MongoDB provisionados.
El valor es FLEX.
Proveedor de servicios en la nube en el que MongoDB Cloud aprovisionó el host multiinquilino. El recurso devuelve este parámetro cuando providerSettings.providerName es FLEX y providerSetting.instanceSizeName es FLEX.
Los valores son AWS, GCP o AZURE.
nivel de clúster, con una capacidad de almacenamiento y memoria por defecto, que se aplica a todos los hosts que contienen datos en tu clúster. Debe configurar providerSettings.providerName en FLEX e indicar el proveedor de servicios en la nube en providerSettings.backingProviderName.
El valor es FLEX.
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_TYPE o NODE_TYPE. El valor por defecto es WORKLOAD_TYPE.
Obsoleto: Utilice replicationSpecs en su lugar. Número de miembros que pertenecen al conjunto de réplicas. Cada miembro conserva una copia de tus bases de datos, proporcionando alta disponibilidad y redundancia de datos.
Los valores son 3, 5 o 7. El valor por defecto es 3.
Ubicación física donde MongoDB nube aprovisiona nodos de clúster.
Ubicación física donde MongoDB nube aprovisiona nodos de clúster.
Número de nodos de análisis en la región. Los nodos de análisis gestionan datos analíticos, como queries de reportes del Connector de MongoDB para Business Intelligence en MongoDB nube. Los nodos de análisis son de solo lectura y nunca pueden convertirse en el primario. Utilice replicationSpecs[n].{region}.analyticsNodes en su lugar.
Número de nodos elegibles que se deben implementar en la región especificada. Los nodos elegibles pueden convertirse en el nodo primario y facilitar lecturas locales. Utiliza replicationSpecs[n].{region}.electableNodes en su lugar.
Los valores son 0, 3, 5 o 7.
Número que indica la prioridad de elección de la región. Para identificar la Región Preferida del clúster, establezca este parámetro en 7. El nodo principal se ejecuta en la Región preferida. Para identificar una región de solo lectura, configura este parámetro en 0.
El valor mínimo es 0, el valor máximo es 7.
Número de nodos de sólo lectura en la región. Los nodos de solo lectura nunca pueden convertirse en el miembro principal, pero pueden facilitar las lecturas locales. Utiliza replicationSpecs[n].{region}.readOnlyNodes en su lugar.
Lista de configuraciones que configuran las regiones de su clúster.
string única de 24dígitos hexadecimales que identifica el objeto de replicación de una zona en un Clúster Global.
Si incluyes zonas existentes en la solicitud, debes especificar este parámetro.
Si se agrega una nueva zona a un clúster global existente, se puede especificar este parámetro. La solicitud elimina cualquier zona existente en un clúster global que se excluya de la solicitud.
El formato debe coincidir con el siguiente patrón: ^([a-f0-9]{24})$.
Un número entero positivo que especifica el número de particiones que se implementarán en cada zona especificada. Si estableces este valor en 1 y clusterType es SHARDED, MongoDB nube implementa un clúster de una única partición. No cree un clúster particionado con una única partición para entornos de producción. Los clústeres de una sola partición no ofrecen los mismos beneficios que las configuraciones de múltiples particiones.
Si estás actualizando un set de réplicas a un clúster shard, no puedes aumentar el número de shards en la misma solicitud de actualización. Debe esperar hasta que el clúster haya completado su actualización a particionado y haya reconectado todos los clientes de la aplicación al router MongoDB antes de agregar nuevas particiones. De lo contrario, tus datos podrían volverse inconsistentes una vez que MongoDB nube comience a distribuir datos entre particiones.
El valor por defecto es 1.
Ubicación física donde MongoDB nube aprovisiona nodos de clúster.
Ubicación física donde MongoDB nube aprovisiona nodos de clúster.
Número de nodos de análisis en la región. Los nodos de análisis gestionan datos analíticos, como queries de reportes del Connector de MongoDB para Business Intelligence en MongoDB nube. Los nodos de análisis son de solo lectura y nunca pueden convertirse en el primario. Utilice replicationSpecs[n].{region}.analyticsNodes en su lugar.
Número de nodos elegibles que se deben implementar en la región especificada. Los nodos elegibles pueden convertirse en el nodo primario y facilitar lecturas locales. Utiliza replicationSpecs[n].{region}.electableNodes en su lugar.
Los valores son 0, 3, 5 o 7.
Número que indica la prioridad de elección de la región. Para identificar la Región Preferida del clúster, establezca este parámetro en 7. El nodo principal se ejecuta en la Región preferida. Para identificar una región de solo lectura, configura este parámetro en 0.
El valor mínimo es 0, el valor máximo es 7.
Número de nodos de sólo lectura en la región. Los nodos de solo lectura nunca pueden convertirse en el miembro principal, pero pueden facilitar las lecturas locales. Utiliza replicationSpecs[n].{region}.readOnlyNodes en su lugar.
Etiqueta legible por humanos que identifica la zona en un clúster global. Proporcione este valor solo si clusterType es GEOSHARDED.
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 es ISRGROOTX1.
Cadena de conexión que puedes utilizar para conectarte al clúster. El modificador +srv obliga a la conexión a usar Transport Layer Security (TLS). El parámetro mongoURI enumera opciones adicionales.
Etiqueta legible por humanos que indica cualquier actividad actual que esté llevando a cabo el plano de control de Atlas en este clúster. Salvo en los estados de CREACIÓN y ELIMINACIÓN, los clústeres siempre deben estar disponibles y disponer de un nodo Primario, incluso cuando se encuentran en estados que indican actividad en curso.
IDLE: Atlas no está realizando ningún cambio en este clúster, y se puede asumir que todos los cambios solicitados a través de la interfaz de usuario o la API se han aplicado.CREATING: Un clúster que se aprovisiona por primera vez retorna el estado CREANDO hasta que esté listo para recibir conexiones. Asegúrese de que la lista de acceso IP y los usuarios de la base de datos estén configurados antes de intentar conectarse.UPDATING: Se está realizando un cambio solicitado a través de la Interfaz de Usuario, API, AutoScaling u otra actividad programada.DELETINGEl clúster está en proceso de borrado y pronto se borrará.REPAIRING: Uno o más nodos del clúster están siendo devueltos al servicio por el plano de control de Atlas. Los demás nodos deben seguir prestando servicio con normalidad.Los valores son IDLE, CREATING, UPDATING, DELETING o REPAIRING.
Lista que contiene pares clave-valor entre 1 y 255 caracteres de longitud para etiquetar y categorizar el clúster.
Par clave-valor que etiqueta y categoriza una organización, proyecto o clúster de MongoDB Cloud. Por ejemplo, environment : production.
Constante que define el conjunto de la etiqueta. Por ejemplo, environment en la etiqueta environment : production.
La longitud mínima es de 1, la longitud máxima es de 255.
Variable que pertenece al conjunto de la etiqueta. Por ejemplo, production en la etiqueta environment : production .
La longitud mínima es de 1, la longitud máxima es de 255.
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 en false, 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 especificar mongoDBMajorVersion.
Los valores son LTS o CONTINUOUS. El valor por defecto es LTS.
Número total de documentos disponibles. Cuando includeCount se establece en false, MongoDB Cloud puede omitir este valor o devolverlo cuando el recuento esté disponible sin cálculos adicionales. El número total es una estimación y puede que no sea exacto.
El valor mínimo es 0.
No autorizado.
Detalle de solicitud incorrecta.
Describe todas las infracciones en una solicitud de cliente.
Describe las condiciones o razones específicas que causan cada tipo de error.
Código de estado HTTP devuelto con este error.
El código de error de la aplicación se devuelve con este error.
Parámetros utilizados para proporcionar más información sobre el error.
Políticas de recursos de Atlas que provocaron que se denegara la solicitud. Se devuelve solo cuando errorCode es ATLAS_RESOURCE_POLICIES_VIOLATION_NOT_AUTHORIZED.
No más de 100 elementos.
Política de recursos de Atlas que provocó la denegación de la solicitud.
string de caracteres hexadecimales de 24única que identifica la política de recursos de Atlas.
El formato debe coincidir con el siguiente patrón: ^([a-f0-9]{24})$.
Etiqueta legible por humanos que identifica la política de recursos de Atlas.
El mensaje de error de la aplicación se devuelve con este error.
Forbidden.
Detalle de solicitud incorrecta.
Describe todas las infracciones en una solicitud de cliente.
Describe las condiciones o razones específicas que causan cada tipo de error.
Código de estado HTTP devuelto con este error.
El código de error de la aplicación se devuelve con este error.
Parámetros utilizados para proporcionar más información sobre el error.
Políticas de recursos de Atlas que provocaron que se denegara la solicitud. Se devuelve solo cuando errorCode es ATLAS_RESOURCE_POLICIES_VIOLATION_NOT_AUTHORIZED.
No más de 100 elementos.
Política de recursos de Atlas que provocó la denegación de la solicitud.
string de caracteres hexadecimales de 24única que identifica la política de recursos de Atlas.
El formato debe coincidir con el siguiente patrón: ^([a-f0-9]{24})$.
Etiqueta legible por humanos que identifica la política de recursos de Atlas.
El mensaje de error de la aplicación se devuelve con este error.
No se ha encontrado.
Detalle de solicitud incorrecta.
Describe todas las infracciones en una solicitud de cliente.
Describe las condiciones o razones específicas que causan cada tipo de error.
Código de estado HTTP devuelto con este error.
El código de error de la aplicación se devuelve con este error.
Parámetros utilizados para proporcionar más información sobre el error.
Políticas de recursos de Atlas que provocaron que se denegara la solicitud. Se devuelve solo cuando errorCode es ATLAS_RESOURCE_POLICIES_VIOLATION_NOT_AUTHORIZED.
No más de 100 elementos.
Política de recursos de Atlas que provocó la denegación de la solicitud.
string de caracteres hexadecimales de 24única que identifica la política de recursos de Atlas.
El formato debe coincidir con el siguiente patrón: ^([a-f0-9]{24})$.
Etiqueta legible por humanos que identifica la política de recursos de Atlas.
El mensaje de error de la aplicación se devuelve con este error.
Error interno del servidor.
Detalle de solicitud incorrecta.
Describe todas las infracciones en una solicitud de cliente.
Describe las condiciones o razones específicas que causan cada tipo de error.
Código de estado HTTP devuelto con este error.
El código de error de la aplicación se devuelve con este error.
Parámetros utilizados para proporcionar más información sobre el error.
Políticas de recursos de Atlas que provocaron que se denegara la solicitud. Se devuelve solo cuando errorCode es ATLAS_RESOURCE_POLICIES_VIOLATION_NOT_AUTHORIZED.
No más de 100 elementos.
Política de recursos de Atlas que provocó la denegación de la solicitud.
string de caracteres hexadecimales de 24única que identifica la política de recursos de Atlas.
El formato debe coincidir con el siguiente patrón: ^([a-f0-9]{24})$.
Etiqueta legible por humanos que identifica la política de recursos de Atlas.
El mensaje de error de la aplicación se devuelve con este error.
curl \
--request GET 'https://cloud.mongodb.com/api/atlas/v1.0/groups/32b6e34b3d91647abb20e7b8/clusters' \
--header "Authorization: Bearer $ACCESS_TOKEN"
{
"links": [
{
"href": "https://cloud.mongodb.com/api/atlas",
"rel": "self"
}
],
"results": [
{
"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"
},
"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",
"databaseEdition": "CORE",
"deleteAfterCreationHours": 42,
"deleteAfterDate": "2026-05-04T09:42:00Z",
"diskSizeGB": 42.0,
"diskWarmingMode": "FULLY_WARMED",
"effectiveDatabaseEdition": "CORE",
"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"
}
],
"totalCount": 42
}
{
"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": 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)",
"error": 500,
"errorCode": "UNEXPECTED_ERROR",
"reason": "Internal Server Error"
}