Este endpoint ha quedado obsoleto desde febrero 2025 ya que hemos dejado de admitir la creación de nuevas instancias sin servidor. Por favor, utiliza el endpoint de actualización de Flex Cluster para actualizar los clústeres Flex.
Actualiza un clúster de nivel compartido a una instancia sin servidor en el proyecto especificado.
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 el cuerpo de la respuesta debe estar en el formato prettyprint.
El valor por defecto es false.
Detalles de la actualización del clúster de nivel compartido en el proyecto especificado.
Etiqueta legible por humanos que identifica la instancia sin servidor.
El formato debe coincidir con el siguiente patrón: ^[a-zA-Z0-9][a-zA-Z0-9-]*$.
Grupo de configuraciones del proveedor de nube que configuran la instancia aprovisionada de MongoDB sin servidor.
Proveedor de servicios en la nube en el que MongoDB Cloud aprovisionó la instancia sin servidor.
Los valores son AWS, AZURE o GCP.
Etiqueta legible por humanos que identifica al proveedor de servicios en la nube.
El valor es SERVERLESS. El valor por defecto es SERVERLESS.
Grupo de configuraciones que configura la copia de seguridad sin servidor.
Indicador que indica si la instancia sin servidor utiliza copia de seguridad continua sin servidor. Si este parámetro es false, la instancia sin servidor usará Basic copia de seguridad.
| Opción | descripción | |---|---| | Copia de seguridad sin servidor | Atlas toma snapshots incrementales de los datos en tu instancia sin servidor cada seis horas y te permite restaurar los datos desde un punto específico en el tiempo dentro de las últimas 72 horas. Atlas también realiza snapshots diarias y conserva estas snapshots diarias durante 35 días. Para más información, consulta Costos de instancia sin servidor. | | Copia de seguridad Básica | Atlas realiza snapshots incrementales de los datos en su instancia sin servidor cada seis horas y solo conserva las dos snapshots más recientes. Puede utilizar esta opción de forma gratuita. |
El valor por defecto es true.
Lista que contiene pares clave-valor de entre 1 y 255 caracteres de longitud para etiquetar y categorizar la instancia sin servidor.
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 la instancia sin servidor. Si se configura en true, MongoDB nube no borrará la instancia sin servidor. Si se establece en false, MongoDB Cloud eliminará la instancia sin servidor.
El valor por defecto es false.
OK
Colección de localizadores de recursos uniformes que apuntan a la base de datos MongoDB.
Lista de cadenas de conexión con reconocimiento de punto final privado que puedes utilizar para conectar a esta instancia sin servidor a través de un punto final privado. Este parámetro solo se devuelve si se creó un nodo privado para esta instancia sin servidor y está DISPONIBLE.
Cadena de conexión de endpoint privado que puedes usar para conectarte a esta instancia sin servidor a través de un endpoint privado.
Lista que contiene los nodos privados a través de los cuales te conectas a MongoDB nube cuando utilizas connectionStrings.privateEndpoint[n].srvConnectionString.
Detalles de un endpoint privado desplegado para esta instancia sin servidor.
string única que el proveedor de nube utiliza para identificar el endpoint privado.
Proveedor de nube donde se implementa el endpoint privado.
Los valores son AWS o AZURE.
Región donde se implementa el endpoint privado.
Cadena de conexión compatible con endpoint privado que utiliza el protocolo mongodb+srv:// para conectarse a MongoDB nube 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).
Tipo de proceso de MongoDB al que se conecta tu aplicación.
El valor es MONGOS.
Cadena de conexión pública que puedes usar para conectarte a esta instancia sin servidores. 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.
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 dígitos hexadecimales 24que identifica la instancia sin servidor.
El formato debe coincidir con el siguiente patrón: ^([a-f0-9]{24})$.
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 de MongoDB en la que se ejecuta la instancia sin servidor.
El formato debe coincidir con el siguiente patrón: ([\d]+\.[\d]+\.[\d]+).
Etiqueta legible por humanos que identifica la instancia sin servidor.
El formato debe coincidir con el siguiente patrón: ^[a-zA-Z0-9][a-zA-Z0-9-]*$.
Grupo de configuraciones del proveedor de nube que configuran la instancia aprovisionada de MongoDB sin servidor.
Proveedor de servicios en la nube en el que MongoDB Cloud aprovisionó la instancia sin servidor.
Los valores son AWS, AZURE o GCP.
Capacidad de almacenamiento de los volúmenes de datos de la instancia expresada en gigabytes. Este valor no es configurable para sin servidor ni para clústeres Flex de manera efectiva.
El límite de tamaño de la 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.
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.
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.
Proveedor de servicios en la nube en el que MongoDB Cloud aprovisionó eficazmente la instancia sin servidor.
Etiqueta legible por humanos que identifica al proveedor de servicios en la nube.
El valor es SERVERLESS. El valor por defecto es SERVERLESS.
Grupo de configuraciones que configura la copia de seguridad sin servidor.
Indicador que indica si la instancia sin servidor utiliza copia de seguridad continua sin servidor. Si este parámetro es false, la instancia sin servidor usará Basic copia de seguridad.
| Opción | descripción | |---|---| | Copia de seguridad sin servidor | Atlas toma snapshots incrementales de los datos en tu instancia sin servidor cada seis horas y te permite restaurar los datos desde un punto específico en el tiempo dentro de las últimas 72 horas. Atlas también realiza snapshots diarias y conserva estas snapshots diarias durante 35 días. Para más información, consulta Costos de instancia sin servidor. | | Copia de seguridad Básica | Atlas realiza snapshots incrementales de los datos en su instancia sin servidor cada seis horas y solo conserva las dos snapshots más recientes. Puede utilizar esta opción de forma gratuita. |
El valor por defecto es true.
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 de entre 1 y 255 caracteres de longitud para etiquetar y categorizar la instancia sin servidor.
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 la instancia sin servidor. Si se configura en true, MongoDB nube no borrará la instancia sin servidor. Si se establece en false, MongoDB Cloud eliminará la instancia sin servidor.
El valor por defecto es false.
Solicitud incorrecta.
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 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.
Pago solicitado.
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.
Conflicto.
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 POST 'https://cloud.mongodb.com/api/atlas/v1.0/groups/32b6e34b3d91647abb20e7b8/clusters/tenantUpgradeToServerless' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"name": "string",
"providerSettings": {
"backingProviderName": "AWS",
"providerName": "SERVERLESS",
"regionName": "string"
},
"serverlessBackupOptions": {
"serverlessContinuousBackupEnabled": true
},
"tags": [
{
"key": "string",
"value": "string"
}
],
"terminationProtectionEnabled": false
}'
{
"name": "string",
"providerSettings": {
"backingProviderName": "AWS",
"providerName": "SERVERLESS",
"regionName": "string"
},
"serverlessBackupOptions": {
"serverlessContinuousBackupEnabled": true
},
"tags": [
{
"key": "string",
"value": "string"
}
],
"terminationProtectionEnabled": false
}
{
"connectionStrings": {
"privateEndpoint": [
{
"endpoints": [
{
"endpointId": "string",
"providerName": "AWS",
"region": "string"
}
],
"srvConnectionString": "string",
"type": "MONGOS"
}
],
"standardSrv": "string"
},
"createDate": "2026-05-04T09:42:00Z",
"groupId": "32b6e34b3d91647abb20e7b8",
"id": "32b6e34b3d91647abb20e7b8",
"links": [
{
"href": "https://cloud.mongodb.com/api/atlas",
"rel": "self"
}
],
"mongoDBVersion": "string",
"name": "string",
"providerSettings": {
"backingProviderName": "AWS",
"effectiveDiskSizeGBLimit": 42,
"effectiveInstanceSizeName": "M10",
"effectiveProviderName": "string",
"providerName": "SERVERLESS",
"regionName": "string"
},
"serverlessBackupOptions": {
"serverlessContinuousBackupEnabled": true
},
"stateName": "IDLE",
"tags": [
{
"key": "string",
"value": "string"
}
],
"terminationProtectionEnabled": false
}
{
"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"
}