db.getUsers()

Nesta página

Definição

Compatibilidade
Acesso necessário
Exemplo

O MongoDB 5.0 é o fim da vida útil a partir de de 2024 outubro. Esta versão da documentação não é mais suportada. Para atualizar sua 5.0 implantação do, consulte o MongoDB 6.0 procedimentos de atualização.

Definição

db.getUsers(<options>)

Retorna informações para todos os usuários no banco de dados.

db.getUsers() encapsula o comando usersInfo: 1.

O método db.getUsers() pode utilizar as seguintes opções:

db.getUsers( {
   showCredentials: <Boolean>,
   filter: <document>
} )

Campo	Tipo	Descrição
`showCredentials`	booleano	Opcional. Defina o campo como verdadeiro para exibir o hash da senha do usuário. Por padrão, este campo é `false`.
`filter`	documento	Opcional. Um documento que especifica `$match` condições de estágio para retornar informações para usuários que correspondem às condições de filtro.

Para mais informações, consulte usersInfo.

Compatibilidade

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

Importante

Este comando não é suportado em clusters MongoDB Atlas . Para obter informações sobre o suporte do Atlas para todos os comandos, consulte Comandos não suportados.

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

Acesso necessário

Para visualizar as informações de outro usuário, você deve ter a viewUser ação no banco de dados do outro usuário.

Os usuários podem ver suas próprias informações.

Exemplo

Visualizar todos os usuários para um banco de dados que corresponda ao filtro especificado

O método db.getUsers() pode aceitar um documento filter para retornar informações sobre os usuários que correspondem à condição do filtro.

Para visualizar todos os usuários do banco de dados atual que têm credenciais do SCRAM-SHA-256:

db.getUsers({ filter: { mechanisms: "SCRAM-SHA-256" } })

Ao visualizar todos os usuários, você pode especificar a opção showCredentials, mas não as opções showPrivileges ou showAuthenticationRestrictions.

Voltar

db.getUser

db.grantRolesToUser