db.updateRole()

정의

db.updateRole( rolename, update, writeConcern )

사용자 정의 역할 업데이트합니다. db.updateRole() 메서드는 역할의 데이터베이스 에서 실행 되어야 합니다.

중요

Mongo쉬 방법

이 페이지에서는 mongosh 메서드에 대해 설명합니다. 이는 데이터베이스 명령 또는 Node.js와 같은 언어별 드라이버에 대한 설명서가 아닙니다.

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

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

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

• db.grantRolesToRole()

• db.grantPrivilegesToRole()

• db.revokeRolesFromRole()

• db.revokePrivilegesFromRole()

경고

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

db.updateRole() 메서드는 다음 구문을 사용합니다.

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

db.updateRole() 메소드는 다음 인수를 허용합니다.

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

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

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

db.updateRole() 메서드는 updateRole 명령을 래핑합니다.

호환성

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

• MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스

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

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

"readWrite"

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

행동

필요한 액세스 권한

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

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

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

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

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

• cluster 리소스

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

예시

다음 db.updateRole() 메서드는 products 데이터베이스에 있는 inventoryControl 역할의 privileges 및 roles를 대체합니다. 이 메서드는 inventoryControl을 포함하는 데이터베이스에서 실행됩니다.

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

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