connectionStatus (comando de banco de dados)

Definição

connectionStatus: Retorna informações sobre a conexão atual, especificamente o estado dos usuários autenticados e suas permissões disponíveis.

Esse comando está disponível em implantações hospedadas nos seguintes ambientes:

Observação

This command is supported in all MongoDB Atlas clusters. For information on Atlas support for all commands, see Unsupported Commands.

MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB
MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB

O comando tem a seguinte sintaxe:

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

connectionStatus suporta o seguinte campo opcional:

Campo	Tipo	Descrição
`showPrivileges`	booleano	Optional. Set `showPrivileges` to true to instruct `connectionStatus` to return the full set of privileges that currently-authenticated users possess. Por padrão, este campo é `false`.

To run connectionStatus use the db.runCommand() method, as in the following:

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

connectionStatus.authInfo: Um documento com dados sobre o estado de autenticação da conexão atual, incluindo usuários e permissões disponíveis.

connectionStatus.authinfo.authenticatedUsers

Uma matriz com documentos para cada usuário autenticado

connectionStatus.authInfo.authenticatedUsers[n].db: O banco de dados associado às credenciais do usuário.

connectionStatus.authinfo.authenticatedUserRoles

Uma matriz com documentos para cada função concedida à conexão atual:

connectionStatus.authinfo.authenticatedUserRoles[n].role: A definição das funções atuais associadas aos usuários autenticados atuais. Consulte Funções Internas e Ações de Privilégio para obter mais informações.

connectionStatus.authinfo.authenticatedUserRoles[n].db: The database to which role applies.

connectionStatus.authInfo.authenticatedUserPrivileges

Uma array com documentos descrevendo as ações concedidas à conexão atual, agrupada por recurso.

connectionStatus.authInfo.authenticatedUserPrivileges[n].resource: A document describing the database and, if applicable, collection to which connectionStatus.authInfo.authenticatedUserPrivileges[n].actions applies.

connectionStatus.authInfo.authenticatedUserPrivileges[n].actions: Uma array listando as ações de privilégio às quais a conexão tem acesso para o recurso especificado.

connectionStatus.ok: O valor de retorno do comando. Um valor de 1 indica o sucesso.