grantRolesToRole

On this page本页内容

Definition定义

grantRolesToRole

Grants roles to a user-defined role.将角色授予用户定义的角色。

The grantRolesToRole command affects roles on the database where the command runs. grantRolesToRole命令影响运行该命令的数据库上的角色。grantRolesToRole has the following syntax:grantRolesToRole具有以下语法：

{ grantRolesToRole: "<role>",
  roles: [
             { role: "<role>", db: "<database>" },
             ...
         ],
  writeConcern: { <write concern> },
  comment: <any>
}

The grantRolesToRole command has the following fields:grantRolesToRole命令具有以下字段：

Field字段Type类型Description描述
grantRolesToRolestringThe name of a role to add subsidiary roles.要添加辅助角色的角色的名称。
rolesarrayAn array of roles from which to inherit.要从中继承的角色数组。
writeConcerndocument

Optional. 可选。The level of write concern for the operation. 操作的写入关注级别。See Write Concern Specification.请参阅写入关注规范。

commentany

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).注释可以是任何有效的BSON类型（字符串、整数、对象、数组等）。

New in version 4.4.在版本4.4中新增。

In the roles field, you can specify both built-in roles and user-defined roles.在roles字段中，可以指定内置角色和用户定义角色。

To specify a role that exists in the same database where grantRolesToRole runs, you can either specify the role with the name of the role:要指定运行grantRolesToRole的同一数据库中存在的角色，可以使用角色名称指定角色：

"readWrite"

Or you can specify the role with a document, as in:也可以使用文档指定角色，如：

{ role: "<role>", db: "<database>" }

To specify a role that exists in a different database, specify the role with a document.若要指定存在于其他数据库中的角色，请使用文档指定该角色。

Behavior行为

A role can inherit privileges from other roles in its database. 角色可以从其数据库中的其他角色继承权限。A role created on the admin database can inherit privileges from roles in any database.在admin数据库上创建的角色可以从任何数据库中的角色继承权限。

Required Access所需访问权限

You must have the grantRole action on a database to grant a role on that database.必须对数据库执行grantRole操作才能在该数据库上授予角色。

Example示例

The following grantRolesToRole command updates the productsReaderWriter role in the products database to inherit the privileges of the productsReader role in the products database:以下grantRolesToRole命令更新products数据库中的productsReaderWriter角色，以继承products数据库中productsReader角色的权限：

use products
db.runCommand(
   { grantRolesToRole: "productsReaderWriter",
     roles: [
              "productsReader"
     ],
     writeConcern: { w: "majority" , wtimeout: 5000 }
   }
)
←  grantPrivilegesToRoleinvalidateUserCache →