Cree una clave API de organización y asígnela a su proyecto.
MongoDB devuelve la clave API privada solo una vez. Después de ejecutar este comando, copie, guarde y proteja inmediatamente las claves API pública y privada. Si no proporciona un rol de nivel de organización, la clave API se establece de forma predeterminada como miembro de la organización principal del proyecto.
Para utilizar este comando, debe autenticarse con una cuenta de usuario, una cuenta de servicio o una clave API con cualquiera de los siguientes roles: Administrador de usuarios del proyecto o Administrador de usuarios de la organización para administrar roles de nivel de organización.
Sintaxis
atlas projects apiKeys create [options]
opciones
Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
--desc | string | true | Descripción de la clave API. |
-h, --ayuda | false | ayuda para crear | |
-o, --output | string | false | Formato de salida. Los valores válidos son json, json-path, go-template o go-template-file. Para ver la salida completa, use la opción -o json. |
--projectId | string | false | Cadena hexadecimal que identifica el proyecto que se utilizará. Esta opción anula la configuración del archivo de configuración o la variable de entorno. |
--role | cadenas | true | Rol o roles que desea asignar a la clave API. Para asignar más de un rol, especifique cada rol con una marca de rol independiente o especifique todos los roles como una lista separada por comas usando una sola marca de rol. Para ver la lista completa de valores aceptados, consulte la enumeración de elementos del punto final de la API de Atlas correspondiente: https://www.mongodb.com/es/docs/api/doc/atlas-admin-api-v2/operation/operation-createprojectapikey. Para obtener más información sobre los roles de usuario a nivel de proyecto, consulte: https://dochub.mongodb.org/core/atlas-proj-roles. |
Opciones heredadas
Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
-P, --profile | string | false | Nombre del perfil que se usará en el archivo de configuración. Para obtener más información sobre los perfiles de la CLI de Atlas, consulte https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. |
Salida
Si el comando se ejecuta correctamente, la CLI devuelve un resultado similar al siguiente ejemplo. Los valores entre paréntesis representan sus valores.
API Key '<Id>' created. Public API Key <PublicKey> Private API Key <PrivateKey>
Ejemplos
# Create an organization API key with the GROUP_OWNER role and assign it to the project with ID 5e2211c17a3e5a48f5497de3: atlas projects apiKeys create --desc "My API key" --projectId 5e1234c17a3e5a48f5497de3 --role GROUP_OWNER --output json
# Create an organization API key with the GROUP_SEARCH_INDEX_EDITOR and GROUP_DATABASE_ACCESS_ADMIN roles and assign it to the project with ID 5e2211c17a3e5a48f5497de3: atlas projects apiKeys create --desc "My API key" --projectId 5e1234c17a3e5a48f5497de3 --role GROUP_SEARCH_INDEX_EDITOR,GROUP_DATABASE_ACCESS_ADMIN --output json