Crear un clúster efímero de Atlas

Crea el clúster efímero.

Envía una solicitud POST al siguiente punto final:

https://cloud.mongodb.com/api/atlas/v2/unauth/ephemeralClusters:create

La solicitud requiere el siguiente encabezado Accept:

Accept: application/vnd.atlas.preview+json

La siguiente solicitud de ejemplo crea un clúster efímero llamado Cluster0:

curl -sS -X POST 'https://cloud.mongodb.com/api/atlas/v2/unauth/ephemeralClusters:create' \
  -H 'Accept: application/vnd.atlas.preview+json' \
  -H 'Content-Type: application/json' \
  -d '{"clusterName": "Cluster0"}'

El endpoint de creación devuelve una respuesta con el siguiente formato:

{
  "claimUrl": "https://account.mongodb.com/account/register?claimId={claimId}",
  "clusterId": "{clusterId}",
  "connectionString": "mongodb+srv://{username}:{password}@{host}/",
  "expiresAt": "{timestamp}",
  "status": "PROVISIONING",
  "termsOfService": "By using this API and any resources provisioned through it, you agree to be bound by MongoDB's Cloud Terms of Service at https://www.mongodb.com/legal/terms-and-conditions/cloud; and Privacy Policy at https://www.mongodb.com/legal/privacy/privacy-policy."
}

La respuesta incluye los siguientes campos:

• claimUrlURL única para reclamar este clúster efímero. Un usuario debe abrir esta URL en un navegador. Válida durante 7 días después de la creación del clúster.

• clusterId: Identificador único del clúster efímero. Para recuperar los detalles status, claimUrl y otros del clúster, envíe una solicitud GET al siguiente punto final, reemplazando {clusterId} con este valor:

  https://cloud.mongodb.com/api/atlas/v2/unauth/ephemeralClusters/{clusterId}

  Para obtener más información, consulte Return One Ephemeral Atlas Cluster.

• connectionStringCadena de conexión que utiliza el protocolo mongodb+srv:// para conectarse al clúster efímero. Incluye el nombre de usuario y la contraseña de un usuario de base de datos autogenerado con permisos de lectura y escritura en el clúster. Cualquier cliente que utilice esta cadena de conexión se autentica como dicho usuario. La respuesta de creación es la única vez que Atlas devuelve la contraseña sin censurar.

• expiresAtFecha y hora en que Atlas pausa el clúster si no se reclama. Un clúster efímero pausado es inaccesible hasta que se reclame. La marca de tiempo utiliza el formato ISO 8601 en UTC.

• status: Estado del grupo efímero. Uno de PROVISIONING, ACTIVE o PAUSED.

• termsOfServiceTenga en cuenta que al usar esta API, acepta los Términos de servicio y la Política de privacidad de MongoDB Cloud. Incluye un enlace a los términos completos.

Para obtener más información sobre el punto final de creación, consulte Crear un clúster de Atlas efímero.

Guarda la cadena de conexión y los valores de reclamación.

A partir de la respuesta de creación, guarda los parámetros connectionString, claimUrl y clusterId. Los necesitarás para conectarte, reclamar y recuperar los detalles del clúster.

Conéctate al clúster efímero.

Utilice el valor connectionString de la respuesta de creación para conectarse al clúster efímero desde un entorno compatible, como por ejemplo:

• Código de la aplicación: Proporcione la cadena de conexión al controlador de MongoDB para su lenguaje de programación al inicializar el objeto cliente que se conecta al clúster. Esta es la opción habitual al conectarse desde una aplicación. Para obtener más información, consulte Conectarse a un clúster mediante bibliotecas cliente.

• Línea de comandos: Proporcione la cadena de conexión como argumento al Shell de MongoDB (mongosh) para conectarse y ejecutar comandos de forma interactiva:

  Ejemplo de conexión por línea de comandos

  mongosh "<connectionString>"

Para obtener más información sobre los métodos de conexión disponibles, consulte la sección Consideraciones.

(Opcional) Reclama el grupo efímero.

Reclamar el clúster efímero es opcional. Si no lo reclama, Atlas lo pausa 2 días después de su creación y lo elimina 7 días después. Al reclamarlo, Atlas lo convierte en un clúster gratuito estándar sin fecha de caducidad. El clúster reclamado conserva todos sus datos y la cadena de conexión que guardó sigue funcionando con las mismas credenciales. Para obtener más información sobre los efectos de reclamar un clúster efímero, consulte Reclamar un clúster efímero.

Para reclamar el clúster, un usuario debe iniciar sesión en Atlas a través de un navegador. Elija una de las siguientes opciones:

• Reclámalo ahora: Comparte el claimUrl solo con la persona que reclamará el clúster. Pueden seguir el procedimiento descrito en «Reclamar un clúster efímero» para reclamarlo.

• Reclamar posteriormente: Guarda el archivo claimUrl en una ubicación segura que permanezca accesible para la persona que reclamará el clúster. Dicha persona podrá reclamar el clúster en cualquier momento dentro de los 7 días posteriores a su creación.

• Reclamar nunca: No tomar ninguna medida. Atlas elimina el clúster 7 días después de su creación.

Inicia sesión en Atlas desde la URL de la reclamación.

1. En un navegador web, abra el archivo claimUrl que guardó de la respuesta de creación para acceder a la página de inicio de sesión de Atlas. La URL de reclamación tiene el siguiente formato, donde {claimId} es un identificador único para el clúster efímero:

   https://account.mongodb.com/account/register?claimId={claimId}

2. En la página de inicio de sesión, inicie sesión en Atlas con una cuenta existente o cree una nueva. Al reclamar el clúster en el siguiente paso, esta cuenta obtendrá acceso administrativo y a la base de datos del clúster.

   Si creas una cuenta nueva, verifica tu correo electrónico antes de continuar.

Configure y reclame el clúster efímero.

Después de iniciar sesión, Atlas mostrará la página de reclamación. En esta página, haga lo siguiente:

1. En el menú desplegable, seleccione una organización existente o seleccione Create new org for this cluster para crear una. Al reclamar el clúster, Atlas lo traslada a la organización seleccionada y crea un proyecto para él allí.

   Importante

   La lista desplegable muestra únicamente las organizaciones en las que tu cuenta de Atlas tiene el rol Organization Owner. Al reclamar el clúster, todos los propietarios de la organización seleccionada podrán administrarlo, así como sus datos.

2. Configure el acceso IP. Para restringir el acceso, elimine 0.0.0.0/0 y permita solo su dirección IP actual (recomendado). Para permitir conexiones desde cualquier dirección IP, mantenga 0.0.0.0/0. Puede restringir el acceso IP más adelante en la configuración Network Access del proyecto.

3. Haz clic en Claim Cluster. Esta es una acción que se realiza una sola vez y que no se puede deshacer.

Revisa la página de confirmación.

Una vez que haya reclamado el clúster, Atlas mostrará una página de confirmación con los nombres de la organización y del proyecto, los detalles del clúster y la configuración de acceso IP que haya elegido.

Haz clic en Go To Project Overview para ver el clúster reclamado en la interfaz de usuario de Atlas.

(Opcional) Reconfigure el clúster reclamado.

Puede reconfigurar el clúster reclamado y su proyecto mediante la interfaz de usuario de Atlas, la interfaz de línea de comandos de Atlas o la API de administración de Atlas. A nivel de clúster, puede escalarlo a un nivel superior para aumentar el almacenamiento. A nivel de proyecto, puede administrar los usuarios de la base de datos y restringir el acceso IP para aumentar la seguridad. Para obtener más información, consulte Administrar clústeres.