Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.
Menu Docs

db.revokeRolesFromUser() (método mongosh)

db.revokeRolesFromUser()

Remove um ou mais roles de um usuário no banco de dados atual.

Importante

Método mongosh

Esta página documenta um método.mongosh Esta não é a documentação para comandos de banco de dados ou drivers específicos de idioma, como Node.js.

Para o comando do banco de dados, consulte o comando revokeRolesFromUser.

Para drivers de API do MongoDB, consulte a documentação do driver do MongoDB específica da linguagem.

O método utiliza a seguinte db.revokeRolesFromUser() sintaxe:

db.revokeRolesFromUser( "<username>", [ <roles> ], { <writeConcern> } )

O método utiliza os seguintes db.revokeRolesFromUser() argumentos:

Parâmetro
Tipo
Descrição

user

string

O nome do usuário de quem revogar as funções.

roles

array

As roles a serem removidas do usuário.

writeConcern

documento

Opcional. O nível da write concern para a operação. Consulte Especificação de write concern.

No campo roles, é possível especificar roles incorporadas e roles definidas pelo usuário.

Para especificar uma role que existe no mesmo banco de dados onde o é executado, você pode especificar a role com o nome db.revokeRolesFromUser() dela:

"readWrite"

Ou você pode especificar a role com um documento, como feito a seguir:

{ role: "<role>", db: "<database>" }

Para especificar uma role existente em outro banco de dados, especifique-a com um documento.

O método db.revokeRolesFromUser() revokeRolesFromUser envolve o comando.

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

Importante

Este comando não é aceito em clusters do MongoDB Atlas. Para obter informações sobre o suporte do Atlas a 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

Se executar em um conjunto de réplicas, db.revokeRolesFromUser() o será executado usando "majority" o preocupação de gravação de por padrão.

É necessário ter a revokeRole ação em um banco de dados para revogar um role nesse banco de dados.

O usuário do products accountUser01 reconhecimento de data center do tem os seguintes roles:

"roles" : [
{ "role" : "assetsReader",
"db" : "assets"
},
{ "role" : "read",
"db" : "stock"
},
{ "role" : "readWrite",
"db" : "products"
}
]

O método a seguir db.revokeRolesFromUser() remove as duas funções do usuário: a função read no stock banco de dados e a função readWrite no products banco de dados, que também é o banco de dados no qual o método é executado:

use products
db.revokeRolesFromUser( "accountUser01",
[ { role: "read", db: "stock" }, "readWrite" ],
{ w: "majority" }
)

O usuário accountUser01 no reconhecimento de data center products agora tem apenas um role restante:

"roles" : [
{ "role" : "assetsReader",
"db" : "assets"
}
]