db.updateRole() (mongosh 메서드)

정의

db.updateRole( rolename, update, writeConcern )

Updates a user-defined role. The db.updateRole() method must run on the role's database.

중요

Mongo쉬 방법

This page documents a mongosh method. This is not the documentation for database commands or language-specific drivers, such as Node.js.

데이터베이스 명령에 대해서는 updateRole 명령을 참조하십시오.

MongoDB API 드라이버의 경우 언어별 MongoDB 드라이버 설명서를 참조하세요.

필드를 업데이트하면 이전 필드의 값이 완전히 바뀝니다. 모든 값을 바꾸지 않고 역할 또는 권한을 부여하거나 제거하려면 다음 방법 중 하나 이상을 사용합니다.

• db.grantRolesToRole()

• db.grantPrivilegesToRole()

• db.revokeRolesFromRole()

• db.revokePrivilegesFromRole()

경고

privileges 또는 roles 배열을 업데이트하면 이전 배열의 값이 완전히 바뀝니다.

The db.updateRole() method uses the following syntax:

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

The db.updateRole() method accepts the following arguments:

Parameter	유형	설명
rolename	문자열	업데이트할 사용자 정의 역할의 이름입니다.
update	문서	사용자의 대체 데이터가 포함된 문서입니다. 이 데이터는 사용자의 해당 데이터를 완전히 대체합니다.
writeConcern	문서	선택 사항입니다. 작업에 대한 쓰기 고려 수준입니다. 쓰기 고려 사양을 참조하세요.

update 문서는 업데이트할 필드와 해당 새 값을 지정합니다. update 문서의 각 필드는 선택사항이지만 문서에는 필드가 하나 이상 포함되어야 합니다. update 문서에 다음과 같은 필드가 있습니다.

필드	유형	설명
privileges	배열	선택 사항입니다. roles 배열을 지정하지 않는 경우 필수입니다. 역할에 부여할 권한입니다. privileges 배열에 대한 업데이트는 이전 배열의 값을 재정의합니다. 권한을 지정하는 구문은 privileges 배열을 참조하세요.
roles	배열	선택 사항입니다. privileges 배열을 지정하지 않는 경우 필수입니다. 이 역할이 권한을 상속하는 역할입니다. roles 배열에 대한 업데이트는 이전 배열의 값을 재정의합니다.
authenticationRestrictions	배열	선택 사항. 서버가 이 역할에 대해 시행하는 인증 제한입니다. 이 역할을 부여받은 사용자에게 연결이 허용되거나 연결할 수 있는 IP 주소 및 CIDR 범위의 목록을 지정합니다.

The db.updateRole() method wraps the updateRole command.

호환성

이 메서드는 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.

• MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전

• MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전

"readWrite"

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

행동

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

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

필요한 액세스 권한

역할을 업데이트하려면 모든 데이터베이스에 revokeRole 작업이 있어야 합니다.

배열을 업데이트하려면 roles 배열에 있는 각 역할의 데이터베이스에 grantRole 작업이 있어야 합니다.

배열을 업데이트하려면 privileges 배열에 있는 각 권한의 데이터베이스에 대해 grantRole 작업이 있어야 합니다. 권한의 리소스가 데이터베이스에 걸쳐 있는 경우 admin 데이터베이스에 grantRole이 있어야 합니다. 권한이 다음 중 하나에 해당하는 경우 권한은 데이터베이스에 걸쳐 있습니다.

• 모든 데이터베이스의 컬렉션

• 모든 컬렉션 및 모든 데이터베이스

• cluster 리소스

역할의 authenticationRestrictions 문서를 업데이트하려면 대상 역할의 데이터베이스에 setAuthenticationRestriction 작업이 있어야 합니다.

예시

The following db.updateRole() method replaces the privileges and the roles for the inventoryControl role that exists in the products database. The method runs on the database that contains inventoryControl:

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

역할의 권한을 보려면 rolesInfo 명령을 사용합니다.