db.getUsers() (método mongosh)

Definição

db.getUsers(<options>)

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

db.getUsers() wraps the usersInfo: 1 command.

The db.getUsers() method can take the following options:

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

Campo	Tipo	Descrição
`showCredentials`	booleano	Opcional. Defina como `true` para exibir o hash da senha do usuário. Por padrão, este campo é `false`.
`showCustomData`	booleano	Opcional. Defina como `false` para omitir o `customData` do usuário da saída. Por padrão, este campo é `true`. Novidades na versão 5.2.
`authenticatedMechanism`	string	Novidades na versão 9.0. Opcional. Defina como uma string que representa um mecanismo de autenticação compatível para determinar onde `db.getUsers()` procura informações de autorização do usuário. Consulte `authenticationMechanisms` para obter uma lista de mecanismos e suas strings associadas. Se este campo não for especificado, o `db.getUsers()` retornará informações do LDAP para usuários definidos no banco de dados `$external` e do banco de dados de autorização local para usuários de SCRAM.
`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

This command is not supported in 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

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.

Exemplos

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

The db.getUsers() method can accept a filter document to return information for users that match the filter condition.

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.

Omitir dados personalizados da saída

Novidades na versão 5.2:

To omit users' custom data from the db.getUsers() output, set the showCustomData option to false.

Utilize o comando createUser para criar um usuário denominado accountAdmin01 no banco de dados do products:

db.getSiblingDB("products").runCommand( {
   createUser: "accountAdmin01",
   pwd: passwordPrompt(),
   customData: { employeeId: 12345 },
   roles: [ { role: 'readWrite', db: 'products' } ]
} )

O usuário contém um campo customData de { employeeId: 12345 }.

To retrieve the user but omit the custom data from the output, run db.getUsers() with showCustomData set to false:

db.getSiblingDB("products").getUsers( { showCustomData: false } )

Saída de exemplo:

{
   users: [
     {
       _id: 'products.accountAdmin01',
       userId: UUID("0955afc1-303c-4683-a029-8e17dd5501f4"),
       user: 'accountAdmin01',
       db: 'products',
       roles: [ { role: 'readWrite', db: 'products' } ],
       mechanisms: [ 'SCRAM-SHA-1', 'SCRAM-SHA-256' ]
     }
   ],
   ok: 1
}

Voltar

db.getUser

db.grantRolesToUser