db.dropRole()¶

On this page

Definition
Behavior
Required Access
Example

Definition¶

db.dropRole(rolename, writeConcern)¶

Deletes a user-defined role from the database on which you run the method.

Important

mongo Shell Method

This page documents a mongo method. This is not the documentation for database commands or language-specific drivers, such as Node.js. To use the database command, see the dropRole command.

For MongoDB API drivers, refer to the language-specific MongoDB driver documentation.

The db.dropRole() method takes the following arguments:

Parameter	Type	Description
`rolename`	string	The name of the user-defined role to remove from the database.
`writeConcern`	document	Optional. The level of write concern for the removal operation. The `writeConcern` document takes the same fields as the `getLastError` command.

Behavior¶

Replica set¶

If run on a replica set, db.dropRole() is executed using "majority" write concern by default.

Required Access¶

You must have the dropRole action on a database to drop a role from that database.

Example¶

The following operations remove the readPrices role from the products database:

copy

use products
db.dropRole( "readPrices", { w: "majority" } )

← db.createRole() db.dropAllRoles() →