status da conexão

Nesta página

Definição

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

O comando tem a seguinte sintaxe:

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

connectionStatus suporta o seguinte campo opcional:

Campo	Tipo	Descrição
`showPrivileges`	booleano	Opcional. Defina `showPrivileges` como true para instruir `connectionStatus` a retornar o conjunto completo deprivilégios que os usuários autenticados atualmente possuem. Por padrão, este campo é `false`.

Para executar connectionStatus, use o método db.runCommand(), conforme descrito a seguir:

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: O banco de dados ao qual o role se aplica.

connectionStatus.authInfo.authenticatedUserPrivileges

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

connectionStatus.authInfo.authenticatedUserPrivileges[n].resource: Um documento que descreve o banco de dados e, se aplicável, a coleção à qual connectionStatus.authInfo.authenticatedUserPrivileges[n].actions se aplica.

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.