connectionStatus (comando de base de datos)

Esta versión de la documentación está archivada y ya no recibe soporte. Para actualizar su implementación 6.0, consulte Procedimientos de actualización de MongoDB.7.0

Definición

connectionStatus: Devuelve información sobre la conexión actual, específicamente el estado de los usuarios autenticados y sus permisos disponibles.

Compatibilidad

Este comando está disponible en implementaciones alojadas en los siguientes entornos:

MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube

Nota

Este comando es compatible con todos los clústeres de MongoDB Atlas. Para obtener información sobre el soporte de Atlas para todos los comandos, consulte Comandos no compatibles.

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.

Sintaxis

El comando tiene la siguiente sintaxis:

db.runCommand(
   {
     connectionStatus: 1,
     showPrivileges: <boolean>
   }
)

Campos de comandos

connectionStatus Admite el siguiente campo opcional:

Campo	Tipo	Descripción
`showPrivileges`	booleano	Opcional. Establezca `showPrivileges` como verdadero para indicar a que devuelva `connectionStatus` el conjunto completo de privilegios que poseen los usuarios autenticados actualmente. De forma predeterminada, este campo es `false`.

Ejemplo

Para ejecutar connectionStatus utilice el método, como se muestra a db.runCommand() continuación:

db.runCommand( { connectionStatus: 1, showPrivileges: true } )

Salida

connectionStatus.authInfo: Un documento con datos sobre el estado de autenticación de la conexión actual, incluidos los usuarios y los permisos disponibles.

connectionStatus.authinfo.authenticatedUsers

Una matriz con documentos para cada usuario autenticado.

connectionStatus.authInfo.authenticatedUsers[n].user: El nombre del usuario.

connectionStatus.authInfo.authenticatedUsers[n].db: La base de datos asociada con las credenciales del usuario.

connectionStatus.authinfo.authenticatedUserRoles

Un arreglo con documentos para cada rol otorgado a la conexión actual:

connectionStatus.authinfo.authenticatedUserRoles[n].role: La definición de los roles actuales asociados a los usuarios autenticados. Consulte Roles integrados y acciones de privilegios para obtener más información.

connectionStatus.authinfo.authenticatedUserRoles[n].db: La base de datos a la que se role aplica.

connectionStatus.authInfo.authenticatedUserPrivileges

Una matriz con documentos que describen las acciones otorgadas a la conexión actual, agrupadas por recurso.

connectionStatus.authInfo.authenticatedUserPrivileges[n].resource: Un documento que describe la base de datos y, si corresponde, la colección a la que se connectionStatus.authInfo.authenticatedUserPrivileges[n].actions aplica.

connectionStatus.authInfo.authenticatedUserPrivileges[n].actions: Una matriz que enumera las acciones de privilegio a las que la conexión tiene acceso para el recurso especificado.

connectionStatus.ok: El valor de retorno del comando. Un valor de 1 indica el éxito.

Volver

connPoolStats

dataSize