db.getUser()

Definición

db.getUser(username, args)

Devuelve la información de un usuario específico. Ejecuta este método en la base de datos del usuario. Si el usuario no existe en la base de datos, db.getUser() nulldevuelve.

El método db.getUser() tiene los siguientes parámetros:

db.getUser( "<username>", {
   showCredentials: <Boolean>,
   showPrivileges: <Boolean>,
   showAuthenticationRestrictions: <Boolean>,
   filter: <document>
} )

Parameter	Tipo	Descripción
username	string	El nombre de usuario para el cual recuperar información.
args	Documento	Opcional. Un documento que especifica argumentos adicionales.

El documento args admite los siguientes campos:

Campo	Tipo	Descripción
showCredentials	booleano	Opcional. Configure este campo como verdadero para mostrar el hash de la contraseña del usuario. Por defecto, este campo es false.
showPrivileges	booleano	Opcional. Configure este campo como verdadero para mostrar todos los privilegios del usuario, incluyendo información ampliada de los roles heredados. De forma predeterminada, este campo es false. Si visualiza todos los usuarios, no puede especificar este campo.
showAuthenticationRestrictions	booleano	Opcional. Configure este campo como verdadero para mostrar las restricciones de autenticación del usuario. Por defecto, este campo es false. Si visualiza todos los usuarios, no puede especificar este campo.
filter	Documento	Opcional. Un documento que especifica $match condiciones de etapa para devolver información de los usuarios que coinciden con las condiciones del filtro.

db.getUser() envuelve el usersInfo: <username> comando.

Para obtener detalles sobre la salida,usersInfo consulte.

Compatibilidad

Este método está disponible en implementaciones alojadas en los siguientes entornos:

• MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB

• MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.

Acceso requerido

Para ver la información de otro usuario, debe tener la acción viewUser en la base de datos de otro usuario.

Los usuarios pueden ver su propia información.

Ejemplo

Las siguientes operaciones devuelven información sobre un usuario de ejemplo appClient en una base de datos accounts:

use accounts
db.getUser("appClient")

Ejemplo de salida:

{
   _id: 'accounts.appClient',
   userId: UUID("1c2fc1bf-c4dc-4a22-8b04-3971349ce0dc"),
   user: 'appClient',
   db: 'accounts',
   roles: [],
   mechanisms: [ 'SCRAM-SHA-1', 'SCRAM-SHA-256' ]
}