updateRole

정의

updateRole

사용자 정의 역할 업데이트합니다. updateRole 명령은 역할의 데이터베이스 에서 실행 되어야 합니다.

팁

mongosh에서 이 명령을 db.updateRole() 헬퍼 메서드를 통해서도 실행할 수 있습니다.

헬퍼 메서드는 mongosh 사용자에게 편리하지만 데이터베이스 명령과 동일한 수준의 정보를 반환하지 못할 수 있습니다. 편의가 필요하지 않거나 추가 리턴 필드가 필요한 경우 데이터베이스 명령을 사용합니다.

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

• grantRolesToRole

• grantPrivilegesToRole

• revokeRolesFromRole

• revokePrivilegesFromRole

경고

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

호환성

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

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

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

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

구문

역할을 업데이트하려면 privileges 배열, roles 배열 또는 둘 다를 제공해야 합니다.

이 명령은 다음과 같은 구문을 사용합니다.

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

명령 필드

이 명령은 다음 필드를 사용합니다.

"readWrite"

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

행동

역할의 권한은 역할이 생성된 데이터베이스에 적용됩니다. 역할은 데이터베이스에 있는 다른 역할로부터 권한을 상속받을 수 있습니다. admin 데이터베이스에서 생성된 역할은 모든 데이터베이스 또는 클러스터에 적용되는 권한을 포함할 수 있으며 다른 데이터베이스의 역할로부터 권한을 상속할 수 있습니다.

필요한 액세스 권한

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

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

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

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

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

• cluster 리소스

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

예시

다음은 admin 데이터베이스에서 myClusterwideAdmin 역할을 업데이트하는 updateRole 명령의 예입니다. privileges } 배열과 roles 배열은 모두 선택 사항이지만 둘 중 하나 이상은 필수입니다.

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

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