Devolver todas las instancias sin servidor en un proyecto Obsoleto

Obtener /api/atlas/v1.0/grupos/{groupId}/sin servidor

Devuelve detalles de todas las instancias sin servidor del proyecto especificado. Para usar este recurso, la cuenta de servicio o la clave API solicitantes deben tener el rol de solo lectura del proyecto.

Este punto de conexión también enumera los clústeres Flex creados con el punto de conexión "Crear instancia sin servidor" o las instancias sin servidor anteriores migradas a clústeres Flex, hasta el de enero 15 del, fecha2026 a partir de la cual este punto de conexión mostrará una lista vacía. El punto de conexión se eliminará por completo el de enero 15 2027del. No se admiten copias de seguridad continuas y el no se aplicará serverlessContinuousBackupEnabled a estos clústeres. Utilice el punto de conexión "Enumerar clústeres Flex" en su lugar.

Lista de clústeres flexibles

Parámetros de ruta

  • ID de grupo string Requerido

    Cadena 24hexadecimal única que identifica su proyecto. Utilice el punto de conexión /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 de tu proyecto. Para los grupos existentes, el ID de tu grupo/proyecto permanece igual. El recurso y los puntos finales correspondientes usan el término "grupos".

    El formato debe coincidir con el siguiente patrón: ^([a-f0-9]{24})$.

Parámetros de consulta

  • envolvente booleano

    Indicador que indica si la aplicación encapsula 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 solucionar esto, configure envelope=true en la consulta. Los endpoints que devuelven una lista de resultados utilizan el objeto de resultados como encapsulado. La aplicación añade el parámetro de estado al cuerpo de la respuesta.

    El valor predeterminado es false.

  • incluirConteo booleano

    Bandera que indica si la respuesta devuelve el número total de elementos (totalCount) en la respuesta.

    El valor predeterminado es true.

  • artículos por página entero

    Número de elementos que la respuesta devuelve por página.

    El valor mínimo es 1, el valor máximo es 500. El valor predeterminado es 100.

  • número de página entero

    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.

  • bonita booleano

    Bandera que indica si el cuerpo de la respuesta debe estar en formato prettyprint.

    El valor predeterminado es false.

    Impresión bonita

Respuestas

  • 200 aplicación/json

    Vale

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • resultados matriz[objeto]

      Lista de documentos devueltos que MongoDB nube proporciona al completar esta solicitud.

      Grupo de configuraciones que configuran una instancia sin servidor de MongoDB.

      Ocultar atributos de resultados Mostrar atributos de resultados Objeto
      • cadenas de conexión Objeto

        Colección de localizadores uniformes de recursos que apuntan a la base de datos MongoDB.

        Formato de URI de cadena de conexión.
        Ocultar atributos de connectionStrings Mostrar atributos de connectionStrings Objeto
        • Nodo privado matriz[objeto]

          Lista de cadenas de conexión que reconocen puntos de conexión privados y que puede usar para conectarse a esta instancia sin servidor a través de un punto de conexión privado. Este parámetro solo se devuelve si creó un punto de conexión 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.

          Ocultar atributos de privateEndpoint Mostrar atributos de privateEndpoint Objeto
          Punto final privado para servidores...
          • puntos finales matriz[objeto]

            Lista que contiene los puntos finales privados a través de los cuales te conectas a MongoDB Cloud cuando usas connectionStrings.privateEndpoint[n].srvConnectionString.

            Detalles de un punto final privado implementado para esta instancia sin servidor.

            Ocultar atributos de puntos finales Mostrar atributos de puntos finales Objeto
            • ID de punto final string

              Cadena única que utiliza el proveedor de la nube para identificar el punto final privado.

            • nombreProveedor string

              Proveedor de nube donde se implementa el punto final privado.

              Los valores son AWS o AZURE.

            • región string

              Región donde se implementa el punto final privado.

          • cadena de conexión srv string

            Cadena de conexión que reconoce puntos finales privados y que utiliza el protocolo mongodb+srv:// para conectarse a MongoDB Cloud a través de un punto final privado. El protocolo mongodb+srv indica al controlador que busque la lista de hosts en el Sistema de Nombres de Dominio (DNS).

          • tipo string

            Tipo de proceso de MongoDB al que se conecta tu aplicación.

            El valor es MONGOS.

        • estándarSrv string

          Cadena de conexión pública que puede usar para conectarse a esta instancia sin servidor. Esta cadena de conexión usa el protocolo mongodb+srv://.

          Formato de URI de cadena de conexión
      • fecha de creación cadena(fecha-hora)

        Fecha y hora en que MongoDB Cloud creó esta instancia sin servidor. MongoDB Cloud representa esta marca de tiempo en formato ISO 8601 en UTC.

      • ID de grupo string

        Cadena de caracteres hexadecimales 24única que identifica el proyecto.

        El formato debe coincidir con el siguiente patrón: ^([a-f0-9]{24})$.

      • ID. string

        Cadena de dígitos hexadecimales 24única que identifica la instancia sin servidor.

        El formato debe coincidir con el siguiente patrón: ^([a-f0-9]{24})$.

      • Versión de MongoDB string

        Versión de MongoDB que ejecuta la instancia sin servidor.

        El formato debe coincidir con el siguiente patrón: ([\d]+\.[\d]+\.[\d]+).

      • Nombre string

        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-]*$.

      • Configuración del proveedor Objeto Requerido

        Grupo de configuraciones del proveedor de nube que configuran la instancia aprovisionada de MongoDB sin servidor.

        Ocultar atributos providerSettings Mostrar atributos de providerSettings Objeto
        • nombreDeProveedorDeRespaldo string Requerido

          Proveedor de servicios en la nube en el que MongoDB Cloud aprovisionó la instancia sin servidor.

          Los valores son AWS, AZURE o GCP.

        • límiteEfctivoTamañoGBDisco integer(int32)

          Capacidad de almacenamiento de los volúmenes de datos de instancia, expresada en gigabytes. Este valor no es configurable para clústeres Serverless ni Flex.

        • nombreDeTamañoDeInstanciaEfectivo string

          El límite de tamaño de la instancia al cual tu clúster puede escalar automáticamente.

          Uno de:

          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 o M400_NVME.

          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 o R600.

        • nombreProveedorEfectivo string

          Proveedor de servicios en la nube en el que MongoDB Cloud aprovisionó efectivamente la instancia sin servidor.

        • nombreProveedor string

          Etiqueta legible por humanos que identifica al proveedor de servicios en la nube.

          El valor es SERVERLESS. El valor predeterminado es SERVERLESS.

        • nombreDeRegión string Requerido

          Etiqueta legible que identifica la ubicación geográfica de su instancia sin servidor de MongoDB. La región que elija puede afectar la latencia de red de los clientes que acceden a sus bases de datos. Para obtener una lista completa de nombres de regiones, consulte AWS, GCP y Azure.

      • Opciones de copia de seguridad sin servidor Objeto

        Grupo de configuraciones que configuran la copia de seguridad sin servidor.

        Ocultar el atributo serverlessBackupOptions Mostrar el atributo serverlessBackupOptions Objeto
        • Copia de seguridad continua sin servidor habilitada booleano

          Marca que indica si la instancia sin servidor utiliza la copia de seguridad continua sin servidor. Si este parámetro false es, la instancia sin servidor utiliza la copia de seguridad básica.

          | Opción | Descripción | |---|---| | Copia de seguridad continua sin servidor | Atlas toma instantáneas incrementales de los datos de su instancia sin servidor cada seis horas y le permite restaurarlos desde un punto seleccionado en las últimas 72 horas. Atlas también toma instantáneas diarias y las conserva durante 35 días. Para obtener más información, consulte Costos de instancias sin servidor. | | Copia de seguridad básica | Atlas toma instantáneas incrementales de los datos de su instancia sin servidor cada seis horas y conserva solo las dos más recientes. Puede usar esta opción gratuitamente. |

          El valor predeterminado es true.

      • nombre del estado string

        Etiqueta legible que indica cualquier actividad actual que el plano de control de Atlas esté realizando en este clúster. Con excepción de los estados CREANDO y ELIMINANDO, los clústeres siempre deben estar disponibles y tener un nodo principal, incluso en estados que indiquen actividad continua.

        • IDLEAtlas no está realizando cambios en este clúster y se puede asumir que se han aplicado todos los cambios solicitados a través de la interfaz de usuario o la API.
        • CREATINGUn clúster que se aprovisiona por primera vez devuelve el estado CREANDO hasta que esté listo para las conexiones. Asegúrese de que la lista de acceso IP y los usuarios de la base de datos estén configurados antes de intentar la conexión.
        • UPDATING: Se está realizando un cambio solicitado a través de la Interfaz de Usuario, API, AutoScaling u otra actividad programada.
        • DELETING:El clúster está en proceso de eliminación y pronto se eliminará.
        • REPAIRINGEl plano de control de Atlas está volviendo a poner en servicio uno o más nodos del clúster. Los demás nodos deberían seguir prestando servicio con normalidad.

        Los valores son IDLE, CREATING, UPDATING, DELETING o REPAIRING.

      • Etiquetas matriz[objeto]

        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.

        Hide tags attributes Mostrar atributos de etiquetas Objeto
        • clave string Requerido

          Constante que define el conjunto de la etiqueta. Por ejemplo, environment en la etiqueta environment : production.

          La longitud mínima es 1, la longitud máxima es 255.

        • valor string Requerido

          Variable que pertenece al conjunto de la etiqueta. Por ejemplo, production en la etiqueta environment : production.

          La longitud mínima es 1, la longitud máxima es 255.

      • TerminaciónProtecciónHabilitada booleano

        Marca que indica si la protección contra terminación está habilitada en la instancia sin servidor. Si se establece en true, MongoDB Cloud no eliminará la instancia sin servidor. Si se establece en false, MongoDB Cloud eliminará la instancia sin servidor.

        El valor predeterminado es false.

    • recuento total integer(int32)

      Número total de documentos disponibles. MongoDB Cloud omite este valor si includeCount se establece en false. El número total es una estimación y puede no ser exacto.

      El valor mínimo es 0.

  • 401 aplicación/json

    No autorizado.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • badRequestDetail Objeto

      Detalle de solicitud incorrecto.

      Ocultar el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
      • campos matriz[objeto]

        Describe todas las violaciones en una solicitud de cliente.

        Ocultar atributos de campos Mostrar atributos de campos Objeto
        • Descripción string Requerido

          Una descripción de por qué el elemento de solicitud es incorrecto.

        • Campo string Requerido

          Una ruta que conduce a un campo en el cuerpo de la solicitud.

    • detalle string

      Describe las condiciones o razones específicas que causan cada tipo de error.

    • Error integer(int32) Requerido

      Código de estado HTTP devuelto con este error.

      Documentación externa
    • errorCode string Requerido

      Código de error de aplicación devuelto con este error.

    • Parámetros matriz[objeto]

      Parámetros utilizados para dar más información sobre el error.

    • razón string

      Se devolvió un mensaje de error de aplicación con este error.

  • 403 aplicación/json

    Forbidden.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • badRequestDetail Objeto

      Detalle de solicitud incorrecto.

      Ocultar el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
      • campos matriz[objeto]

        Describe todas las violaciones en una solicitud de cliente.

        Ocultar atributos de campos Mostrar atributos de campos Objeto
        • Descripción string Requerido

          Una descripción de por qué el elemento de solicitud es incorrecto.

        • Campo string Requerido

          Una ruta que conduce a un campo en el cuerpo de la solicitud.

    • detalle string

      Describe las condiciones o razones específicas que causan cada tipo de error.

    • Error integer(int32) Requerido

      Código de estado HTTP devuelto con este error.

      Documentación externa
    • errorCode string Requerido

      Código de error de aplicación devuelto con este error.

    • Parámetros matriz[objeto]

      Parámetros utilizados para dar más información sobre el error.

    • razón string

      Se devolvió un mensaje de error de aplicación con este error.

  • 404 aplicación/json

    No se encontró.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • badRequestDetail Objeto

      Detalle de solicitud incorrecto.

      Ocultar el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
      • campos matriz[objeto]

        Describe todas las violaciones en una solicitud de cliente.

        Ocultar atributos de campos Mostrar atributos de campos Objeto
        • Descripción string Requerido

          Una descripción de por qué el elemento de solicitud es incorrecto.

        • Campo string Requerido

          Una ruta que conduce a un campo en el cuerpo de la solicitud.

    • detalle string

      Describe las condiciones o razones específicas que causan cada tipo de error.

    • Error integer(int32) Requerido

      Código de estado HTTP devuelto con este error.

      Documentación externa
    • errorCode string Requerido

      Código de error de aplicación devuelto con este error.

    • Parámetros matriz[objeto]

      Parámetros utilizados para dar más información sobre el error.

    • razón string

      Se devolvió un mensaje de error de aplicación con este error.

  • 409 aplicación/json

    Conflicto.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • badRequestDetail Objeto

      Detalle de solicitud incorrecto.

      Ocultar el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
      • campos matriz[objeto]

        Describe todas las violaciones en una solicitud de cliente.

        Ocultar atributos de campos Mostrar atributos de campos Objeto
        • Descripción string Requerido

          Una descripción de por qué el elemento de solicitud es incorrecto.

        • Campo string Requerido

          Una ruta que conduce a un campo en el cuerpo de la solicitud.

    • detalle string

      Describe las condiciones o razones específicas que causan cada tipo de error.

    • Error integer(int32) Requerido

      Código de estado HTTP devuelto con este error.

      Documentación externa
    • errorCode string Requerido

      Código de error de aplicación devuelto con este error.

    • Parámetros matriz[objeto]

      Parámetros utilizados para dar más información sobre el error.

    • razón string

      Se devolvió un mensaje de error de aplicación con este error.

  • 500 aplicación/json

    Error Interno del Servidor.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • badRequestDetail Objeto

      Detalle de solicitud incorrecto.

      Ocultar el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
      • campos matriz[objeto]

        Describe todas las violaciones en una solicitud de cliente.

        Ocultar atributos de campos Mostrar atributos de campos Objeto
        • Descripción string Requerido

          Una descripción de por qué el elemento de solicitud es incorrecto.

        • Campo string Requerido

          Una ruta que conduce a un campo en el cuerpo de la solicitud.

    • detalle string

      Describe las condiciones o razones específicas que causan cada tipo de error.

    • Error integer(int32) Requerido

      Código de estado HTTP devuelto con este error.

      Documentación externa
    • errorCode string Requerido

      Código de error de aplicación devuelto con este error.

    • Parámetros matriz[objeto]

      Parámetros utilizados para dar más información sobre el error.

    • razón string

      Se devolvió un mensaje de error de aplicación con este error.

GET /api/atlas/v1.0/groups/{groupId}/sin servidor
curl \
 --request GET 'https://cloud.mongodb.com/api/atlas/v1.0/groups/32b6e34b3d91647abb20e7b8/serverless' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Ejemplos de respuestas (200)
{
  "links": [
    {
      "href": "https://cloud.mongodb.com/api/atlas",
      "rel": "self"
    }
  ],
  "results": [
    {
      "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
    }
  ],
  "totalCount": 42
}
Ejemplos de respuestas (401)
{
  "error": 401,
  "detail": "(This is just an example, the exception may not be related to this endpoint)",
  "reason": "Unauthorized",
  "errorCode": "NOT_ORG_GROUP_CREATOR"
}
Ejemplos de respuestas (403)
{
  "error": 403,
  "detail": "(This is just an example, the exception may not be related to this endpoint)",
  "reason": "Forbidden",
  "errorCode": "CANNOT_CHANGE_GROUP_NAME"
}
Ejemplos de respuestas (404)
{
  "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"
}
Ejemplos de respuestas (409)
{
  "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"
}
Ejemplos de respuestas (500)
{
  "error": 500,
  "detail": "(This is just an example, the exception may not be related to this endpoint)",
  "reason": "Internal Server Error",
  "errorCode": "UNEXPECTED_ERROR"
}