db.dropRole()

Definition

  • db.dropRole(rolename, writeConcern)
  • Deletes a user-defined role from thedatabase on which you run the method.

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

ParameterTypeDescriptionrolenamestringThe name of the user-defined role to removefrom the database.writeConcerndocumentOptional. The level of write concern for theremoval operation. The writeConcern document takes the samefields as the getLastError command.

The db.dropRole() method wraps the dropRolecommand.

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 dropRoleaction on a database to drop a role from that database.

Example

The following operations remove the readPrices role from theproducts database:

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