Docs Menu

Docs HomeMongoDB Manual

dropRole

On this page

  • Definition
  • Syntax
  • Command Fields
  • Required Access
  • Example
dropRole

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

The command has the following syntax:

db.runCommand(
{
dropRole: "<role>",
writeConcern: { <write concern> },
comment: <any>
}
)

The command has the following fields:

Field
Type
Description
dropRole
string
The name of the user-defined role to remove from the database.
writeConcern
document

Optional. The level of write concern for the operation. See Write Concern Specification.

comment
any

Optional.

A user-provided comment to attach to this command. Once set, this comment appears alongside records of this command in the following locations:

A comment can be any valid BSON type (string, integer, object, array, etc).

New in version 4.4.

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

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

use products
db.runCommand(
{
dropRole: "readPrices",
writeConcern: { w: "majority" }
}
)
←  createRoledropAllRolesFromDatabase →
Give Feedback
© 2022 MongoDB, Inc.

About

  • Careers
  • Investor Relations
  • Legal Notices
  • Privacy Notices
  • Security Information
  • Trust Center
© 2022 MongoDB, Inc.