On this page

• Definition
• Behavior
• Required Access
• Example

Definition

db. dropAllRoles ( writeConcern )

Deletes all user-defined roles on the database where you run the method.

Warning

The dropAllRoles method removes all user-defined roles from the database.

The dropAllRoles method takes the following argument:

Field	Type	Description
writeConcern	document	Optional. The level of write concern for the removal operation. The writeConcern document takes the same fields as the getLastError command.

Returns:	The number of user-defined roles dropped.

The db.dropAllRoles() method wraps the dropAllRolesFromDatabase command.

Behavior

Required Access

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

Example

The following operations drop all user-defined roles from the products database and uses a write concern of majority.

use products
db.dropAllRoles( { w: "majority" } )

The method returns the number of roles dropped:

4