updateRole

定义¶

updateRole¶

更新用户定义的角色。该 updateRole命令必须在角色的数据库上运行。

对字段的更新将完全替换前一个字段的值。要授予或删除角色或特权而不替换所有值，请使用以下一个或多个命令：

• grantRolesToRole
• grantPrivilegesToRole
• revokeRolesFromRole
• revokePrivilegesFromRole

警告

对privilegesor roles数组的更新将完全替换先前数组的值。

该updateRole命令使用以下语法。要更新的角色，你必须提供privileges阵列，roles 阵列，或两者：

复制

{
  updateRole: "<role>",
  privileges:
      [
        { resource: { <resource> }, actions: [ "<action>", ... ] },
        ...
      ],
  roles:
      [
        { role: "<role>", db: "<database>" } | "<role>",
        ...
      ],
  authenticationRestrictions:
      [
        {
          clientSource: ["<IP>" | "<CIDR range>", ...],
          serverAddress: ["<IP>", ...]
        },
        ...
      ]
  writeConcern: <write concern document>
}

该updateRole命令具有以下字段：

领域	类型	描述
updateRole	串	要更新的用户定义角色角色的名称。
privileges	数组	可选的。如果未指定roles数组，则为必需。授予角色的特权。对该privileges 数组的更新将覆盖以前的数组的值。有关指定特权的语法，请参见privileges 数组。
roles	数组	可选的。如果未指定privileges数组，则为必需。该角色从中继承特权的角色。对该roles数组的更新将 覆盖以前的数组的值。
authenticationRestrictions	数组	可选的。 服务器对角色强制执行的身份验证限制。指定允许授予该角色的用户连接和/或可以从其连接的IP地址和CIDR范围的列表 。 3.6版的新功能。
writeConcern	文献	可选的。更新操作的写入关注级别。该writeConcern文档与getLastError命令使用相同的字段。

"readWrite"

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

行为¶

角色的特权适用于创建角色的数据库。该角色可以从其数据库中的其他角色继承特权。在admin数据库上创建的角色可以包括适用于所有数据库或群集的特权，并且可以从其他数据库中的角色继承特权。

所需的访问权限¶

您必须对所有数据库执行操作才能更新角色。revokeRole

您必须对阵列中每个角色的数据库具有操作，才能更新阵列。grantRole roles

您必须对阵列中每个特权的数据库具有操作才能更新阵列。如果特权的资源跨越数据库，则您必须在数据库上拥有该 资源。如果特权是以下任意一项，则特权跨越数据库：grantRole privilegesgrantRoleadmin

• 所有数据库中的一个集合
• 所有集合和所有数据库
• 该cluster资源

您必须对目标角色的数据库具有操作，才能更新角色的文档。setAuthenticationRestriction authenticationRestrictions

例子¶

以下是updateRole更新数据库myClusterwideAdmin角色的命令示例admin。尽管privileges和 roles数组都是可选的，但至少需要两个之一：

db.adminCommand(
   {
     updateRole: "myClusterwideAdmin",
     privileges:
         [
           {
             resource: { db: "", collection: "" },
             actions: [ "find" , "update", "insert", "remove" ]
           }
         ],
     roles:
         [
           { role: "dbAdminAnyDatabase", db: "admin" }
         ],
     writeConcern: { w: "majority" }
   }
)

要查看角色的特权，请使用rolesInfo命令。