db.revokePrivilegesFromRole()（mongosh方法）

定义

db.revokePrivilegesFromRole(rolename, privileges, writeConcern)

在该方法运行的数据库上，删除用户定义角色的指定特权。

重要

mongosh 方法

本页面提供 mongosh 方法的相关信息。这不是数据库命令或特定语言驱动程序（例如 Node.js）的相关文档。

有关数据库命令，请参阅 revokePrivilegesFromRole 命令。

如需了解 MongoDB API 驱动程序，请参阅特定语言的 MongoDB 驱动程序文档。

db.revokePrivilegesFromRole() 方法使用的语法如下：

db.revokePrivilegesFromRole(
    "<rolename>",
    [
        { resource: { <resource> }, actions: [ "<action>", ... ] },
        ...
    ],
    { <writeConcern> }
)

db.revokePrivilegesFromRole() 方法接受以下参数：

Parameter	类型	说明
`rolename`	字符串	要撤销权限的用户定义角色的名称。
`privileges`	阵列	要从角色中删除的权限数组。有关权限格式的更多信息，请参阅`privileges` 。
`writeConcern`	文档	可选。操作的写关注级别。请参阅写关注规范。

兼容性

此方法可用于以下环境中托管的部署：

重要

MongoDB Atlas集群不支持此命令。有关Atlas支持所有命令的信息，请参阅不支持的命令。

MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本
MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本

行为

副本集

如果在副本集上运行，则默认情况下使用 "majority" 写关注执行 db.revokePrivilegesFromRole()。

范围

要撤销权限，资源文档模式必须与该权限的resource字段完全匹配。 actions字段可以是子集，也可以完全匹配。

例如，假设products数据库中的accountRole角色具有将products数据库指定为资源的以下特权：

{
  "resource" : {
      "db" : "products",
      "collection" : ""
  },
  "actions" : [
      "find",
      "update"
  ]
}

您无法仅从products数据库中的一个集合中撤销find和/或update 。以下操作不会导致角色发生变化：

use products
db.revokePrivilegesFromRole(
   "accountRole",
   [
     {
       resource : {
          db : "products",
          collection : "gadgets"
       },
       actions : [
          "find",
          "update"
       ]
     }
   ]
)
db.revokePrivilegesFromRole(
   "accountRole",
   [
     {
       resource : {
          db : "products",
          collection : "gadgets"
       },
       actions : [
          "find"
       ]
     }
   ]
)

要撤销角色accountRole中的"find"和/或"update"操作，必须与资源文档完全匹配。例如，以下操作仅撤销现有特权中的"find"操作。

use products
db.revokePrivilegesFromRole(
   "accountRole",
   [
     {
       resource : {
          db : "products",
          collection : ""
       },
       actions : [
          "find"
       ]
     }
   ]
)

特权

当您指定privileges 大量时，可以指定要应用数据库中的多个集合或整个数据库的权限。

以下语法指定对 products数据库中多个集合的权限。

privileges: [
     {
     resource: { db: 'products', collection: 'coll1' },
     actions: [ 'bypassDocumentValidation' ]
     },
     {
     resource: { db: 'products', collection: 'coll2' },
     actions: [ 'bypassDocumentValidation' ]
     }
]

以下语法指定对 products数据库中所有集合的权限。

privileges: [
     {
     resource: { db: 'products', collection: '' },
     actions: [ 'bypassDocumentValidation' ]
     }
]

必需的访问权限

您必须对特权的目标数据库执行revokeRole操作才能撤销该特权。如果特权针对多个数据库或cluster资源，则必须对admin数据库拥有revokeRole操作。

例子

以下操作会删除associates角色的多个特权：

db.revokePrivilegesFromRole(
   "associate",
   [
     {
       resource: { db: "products", collection: "" },
       actions: [ "createCollection", "createIndex", "find" ]
     },
     {
       resource: { db: "products", collection: "orders" },
       actions: [ "insert" ]
     }
   ],
   { w: "majority" }
)

后退

db.grantPrivilegesToRole

来年

db.grantRolesToRole