db.updateRole() (método mongosh)

Definición

db.updateRole( rolename, update, writeConcern )

Actualizaciones a Rol definido por el usuario. El método debe ejecutarse en la base de datos del rol.db.updateRole()

Importante

Método mongosh

Esta página documenta un método mongosh. Esta no es la documentación para los comandos de base de datos ni para los drivers específicos de lenguajes, como Nodo.js.

Para el comando de base de datos, consulta el comando updateRole.

Para los drivers de API de MongoDB, consulte la documentación del driver de MongoDB específica del lenguaje.

Una actualización de un campo reemplaza completamente los valores del campo anterior. Para otorgar o eliminar roles o privilegios sin reemplazar todos los valores, utilice uno o más de los siguientes métodos:

• db.grantRolesToRole()

• db.grantPrivilegesToRole()

• db.revokeRolesFromRole()

• db.revokePrivilegesFromRole()

Advertencia

Una actualización de la matriz privileges o roles reemplaza completamente los valores de la matriz anterior.

El método utiliza la siguiente db.updateRole() sintaxis:

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

El método acepta los siguientes db.updateRole() argumentos:

Parameter	Tipo	Descripción
rolename	string	El nombre del rol definido por el usuario que se actualizará.
update	Documento	Un documento que contiene los datos de reemplazo del rol. Estos datos reemplazan completamente los datos correspondientes.
writeConcern	Documento	Opcional. El nivel de confirmación de escritura (write concern) de la operación. Consulte Especificación de nivel de confirmación de escritura (write concern).

El documento update especifica los campos que se actualizarán y los nuevos valores. Cada campo del documento update es opcional, pero el documento debe incluir al menos un campo. El documento update tiene los siguientes campos:

Campo	Tipo	Descripción
privileges	arreglo	Opcional. Obligatorio si no se especifica la matriz. Los privilegios para otorgar el rol. Una actualización de roles la privileges matriz anula los valores de la matriz anterior. Para conocer la sintaxis para especificar un privilegio, consulte la privileges matriz.
roles	arreglo	Opcional. Obligatorio si no privileges se especifica la matriz. Los roles de los que este rol hereda privilegios. Una actualización de la roles matriz anula los valores de la matriz anterior.
authenticationRestrictions	arreglo	Opcional. Las restricciones de autenticación que el servidor aplica al rol. Especifica una lista de direcciones IP y Los rangosCIDR a los que se les otorga este rol pueden conectarse y/o desde los cuales pueden conectarse.

El método db.updateRole() envuelve el comando updateRole.

Compatibilidad

Este método está disponible en implementaciones alojadas en los siguientes entornos:

• MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB

• MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.

"readWrite"

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

Comportamiento

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

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

Acceso requerido

Debe tener la revokeRole acción en todas las bases de datos para poder actualizar un rol.

Debe tener la grantRole acción en la base de datos de cada rol en la roles matriz para actualizar la matriz.

Debe tener la grantRole acción en la base de datos de cada privilegio de la privileges matriz para actualizarla. Si el recurso de un privilegio abarca varias bases de datos, debe tener en grantRole la admin base de datos. Un privilegio abarca varias bases de datos si cumple alguno de los siguientes requisitos:

• una colección en todas las bases de datos

• Todas las colecciones y todas las bases de datos

• el recurso cluster

Debe tener la setAuthenticationRestriction acción en la base de datos del rol de destino para actualizar el authenticationRestrictions documento de un rol.

Ejemplo

El siguiente db.updateRole() método reemplaza y para privileges roles el inventoryControl rol existente en la products base de datos. El método se ejecuta en la base de datos que inventoryControl contiene:

use products
db.updateRole(
    "inventoryControl",
    {
      privileges:
          [
            {
              resource: { db:"products", collection:"clothing" },
              actions: [ "update", "createCollection", "createIndex"]
            }
          ],
      roles:
          [
            {
              role: "read",
              db: "products"
            }
          ]
    },
    { w:"majority" }
)

Para ver los privilegios de un rol, utilice el rolesInfo comando.