- Esta versión de la documentación está archivada y ya no se admite. Ver la Documentación actual para aprender cómo actualizar su versión de Atlas CLI.
Seleccione un método de conexión
Cuando se conecta a una cuenta Atlas existente desde la CLI de Atlas, puede autenticarse con uno de los siguientes comandos:
Comando | Método de autenticación | Caso de uso |
|---|---|---|
| Credenciales de inicio de sesión de Atlas y un token de autenticación | Mejor para uso no programático |
| Claves API | Ideal para uso programático |
Importante
Las claves API se almacenan en texto sin formato en el archivo de configuración de Atlas CLI. Tus claves API son como contraseñas. Asegúrate de asegurar adecuadamente el archivo de configuración.
Para crear una nueva cuenta Atlas o incorporar una cuenta existente que no tenga ningún clúster, consulte Comience a utilizar Atlas.
Seleccione un caso de uso a continuación para aprender más sobre las opciones de conexión disponibles:
Utilice el atlas auth login comando para autenticarse con sus credenciales de inicio de sesión de Atlas y un token de autenticación de un solo uso. atlas auth
login requiere inicio de sesión manual y la verificación de un token de autenticación, válido durante 12 horas. Las claves de API son opcionales al conectarse atlas auth login con.
Después de ejecutar atlas auth login, puedes:
Conectarse con la configuración mínima requerida y especificar las banderas
--projectIdy--orgIdcon cada comando. Esta es la manera más rápida de comenzar para el primer inicio de sesión.Guarda tus configuraciones de conexión en un perfil. Perfiles almacenan los identificadores del proyecto, los identificadores de la organización y, opcionalmente, las claves API para usar en futuras sesiones de Atlas CLI. Para ahorrar tiempo, puedes especificar un perfil en lugar de usar las banderas
--projectIdy--orgIdcon cada comando.
Debe configurar las claves de API para autenticarse con este comando.
Cuando atlas config init ejecuta el comando, la CLI de Atlas le solicita que proporcione sus claves de API y crea automáticamente un perfil que almacena las claves de API. atlas config init es mejor para uso programático porque no requiere inicio de sesión manual ni verificación de token.
Cuando usas conectar con atlas config init, puedes:
Conectarse con la configuración mínima requerida y especificar las banderas
--projectIdy--orgIdcon cada comando. Esta es la manera más rápida de comenzar para el primer inicio de sesión.Guarda configuraciones adicionales de conexión en un perfil. Perfiles almacenan los identificadores del proyecto, los identificadores de la organización y, opcionalmente, las claves API para usar en futuras sesiones de Atlas CLI. Para ahorrar tiempo, puedes especificar un perfil en lugar de usar las banderas
--projectIdy--orgIdcon cada comando.
Conéctate con la configuración mínima requerida
Seleccione un caso de uso y siga los pasos para conectarse desde la Atlas CLI con la configuración mínima necesaria.
Completar los requisitos previos
Añadir la dirección IP del host a la lista de acceso IP.
Si se autentica con las credenciales de usuario de Atlas y los propietarios de su organización habilitan la lista de acceso IP para la Interfaz de Usuario de Atlas para una organización, su dirección IP debe ser añadida a la lista de acceso IP para ejecutar comandos en esta organización. Para obtener más información, consultar Requiere lista de acceso IP para la Interfaz de Usuario de Atlas.
Siga estos pasos
Seleccione un caso de uso y siga el procedimiento para conectarse rápidamente desde el Atlas CLI.
Regresar a la Atlas CLI y acepte las opciones de perfil por defecto.
Regresar a la terminal. Si se conecta correctamente, verá un mensaje:
Successfully logged in as {Your Email Address}.
Acepte la configuración de perfil por defecto pulsando Enter si aparecen las siguientes opciones:
Default Org IDDefault Project IDDefault Output FormatDefault MongoDB Shell Path
Importante
Si previamente configuraste algún perfil con claves API para MongoCLI, tus perfiles se migran automáticamente. Algunos perfiles migrados podrían hacer que los comandos de Atlas CLI fallen al autenticarse con atlas auth login. El siguiente mensaje se muestra cuando ejecuta atlas auth login si hay un conflicto:
There was an error fetching your organizations: Global user is from outside access listed subnets.
Para resolver el conflicto, abrir el archivo de configuración, eliminar el perfil por defecto y ejecutar atlas auth login nuevamente.
Emite comandos utilizando los indicadores --projectId --orgId y.
Cuando se ejecuten comandos de Atlas CLI durante la sesión de Atlas CLI, especificar el ID del grupo y ID de organización usando las banderas --projectId y --orgId.
Ejemplo
atlas alerts list --projectId 60b3c81153cf986293e2608b
Emite comandos utilizando los indicadores --projectId --orgId y.
Cuando se ejecuten comandos de Atlas CLI durante la sesión de Atlas CLI, especificar el ID del grupo y ID de organización usando las banderas --projectId y --orgId.
Ejemplo
atlas alerts list --projectId 60b3c81153cf986293e2608b
Da los siguientes pasos
Comience a usar los comandos de Atlas CLI.
Para guardar la configuración de conexión modificando el perfil por defecto o crear un perfil diferente, consulta Guardar la configuración de conexión.