db.updateRole()

Definição

db.updateRole( rolename, update, writeConcern )

Atualiza um role definido pelo usuário. O método db.updateRole() deve ser executado no banco de dados do role.

Importante

Método mongosh

Esta página documenta um método mongosh . Esta não é a documentação para comandos de banco de dados ou drivers específicos de idioma, como Node.js.

Para o comando do banco de dados, consulte o comando updateRole.

Para drivers de API do MongoDB, consulte a documentação do driver MongoDB específica do idioma.

Para a documentação de shell legada do mongo, consulte a documentação para a versão correspondente do MongoDB Server:

mongo shell v4.4

Uma atualização em um campo substitui completamente os valores do campo anterior. Para conceder ou remover roles ou privilégios sem substituir todos os valores, utilize um ou mais dos seguintes métodos:

• db.grantRolesToRole()

• db.grantPrivilegesToRole()

• db.revokeRolesFromRole()

• db.revokePrivilegesFromRole()

Aviso

Uma atualização na array privileges ou roles substitui completamente os valores da matriz anterior.

O método db.updateRole() utiliza a seguinte sintaxe:

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

O método db.updateRole() aceita os seguintes argumentos:

Parâmetro	Tipo	Descrição
rolename	string	O nome da role definida pelo usuário a ser atualizada.
update	documento	Um documento contendo os dados de substituição para a role. Esses dados substituem por completo os dados correspondentes para a role.
writeConcern	documento	Opcional. O nível da write concern para a operação. Consulte Especificação de write concern.

O documento update especifica os campos a serem atualizados e os novos valores. Cada campo no documento update é opcional, mas o documento deve incluir pelo menos um campo. O documento update tem os seguintes campos:

Campo	Tipo	Descrição
privileges	variedade	Opcional. Obrigatório se você não especificar o array roles. Os privilégios para conceder a role. Uma atualização no array privileges substitui os valores do array anterior. Para saber a sintaxe para especificar um privilégio, consulte o array privileges.
roles	variedade	Opcional. Obrigatório se você não especificar o array privileges. As roles das quais esta herda privilégios. Uma atualização no array roles substitui os valores do array anterior.
authenticationRestrictions	variedade	Opcional. As restrições de autenticação que o servidor impõe ao role. Especifica uma lista de endereços IP e os usuários do CIDR têm permissão para se conectar e/ou a partir da qual podem se conectar. Novidade na versão 3.6.

O método db.updateRole() envolve o comando updateRole .

"readWrite"

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

Comportamento

Acesso obrigatório

Você deve ter a ação revokeRole em todos os bancos de dados para atualizar uma role.

Você deve ter a ação grantRole no banco de dados de cada role no array roles para atualizar o array.

Você deve ter a ação grantRole no banco de dados de cada privilégio no array privileges para atualizar o array. Se o recurso de um privilégio abrange bancos de dados, você deverá ter grantRole no banco de dados admin. Um privilégio abrange bancos de dados se o privilégio for qualquer um dos seguintes:

• uma collection em todos os bancos de dados

• todas as collections e todos os bancos de dados

• o recurso cluster

Você deve ter a ação setAuthenticationRestriction no banco de dados da role de destino para atualizar o documento authenticationRestrictions de uma role.

Exemplo

O método db.updateRole() a seguir substitui privileges e roles pela role inventoryControl que existe no banco de dados products . O método é executado no banco de dados que contém inventoryControl:

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

Para visualizar os privilégios de uma role, utilize o comando rolesInfo.