db.revokePrivilegesFromRole()
定義
db.revokePrivilegesFromRole(rolename, privileges, writeConcern)
メソッドが実行されるデータベース上のユーザー定義ロールから指定された権限を削除します。
重要
mongosh メソッド
このページでは、
mongosh
メソッドについて説明します。ただし、データベースコマンドや Node.js などの言語固有のドライバーのドキュメントには該当しません。データベースコマンドについては、
revokePrivilegesFromRole
コマンドを参照してください。MongoDB API ドライバーについては、各言語の MongoDB ドライバー ドキュメントを参照してください。
db.revokePrivilegesFromRole()
メソッドの構文は次のとおりです。db.revokePrivilegesFromRole( "<rolename>", [ { resource: { <resource> }, actions: [ "<action>", ... ] }, ... ], { <writeConcern> } ) db.revokePrivilegesFromRole()
メソッドは次の引数を取ります。Parameterタイプ説明rolename
string特権を取り消すユーザー定義のロールの名前。privileges
配列ロールから削除する特権の配列。 特権の形式の詳細については、privileges
を参照してください。writeConcern
ドキュメント任意。 操作の 書込み保証( write concern ) のレベル。 詳しくは、 書込み保証(write concern) の仕様を参照してください。
動作
レプリカセット
レプリカセットで実行する場合、 db.revokePrivilegesFromRole()
はデフォルトで"majority"
書込み保証を使用して実行されます。
スコープ
特権を取り消すには、リソース ドキュメントパターンがその特権のresource
フィールドと完全に一致する必要があります。 actions
フィールドはサブセットまたは完全一致にすることができます。
たとえば、 products
データベースのロールaccountRole
が、 products
データベースをリソースとして指定する次の特権を持つとします。
{ "resource" : { "db" : "products", "collection" : "" }, "actions" : [ "find", "update" ] }
products
データベース内の1 つのコレクションのみからfind
および/またはupdate
を取り消すことはできません。 次の操作では、 ロールは変更されません。
use products db.revokePrivilegesFromRole( "accountRole", [ { resource : { db : "products", collection : "gadgets" }, actions : [ "find", "update" ] } ] ) db.revokePrivilegesFromRole( "accountRole", [ { resource : { db : "products", collection : "gadgets" }, actions : [ "find" ] } ] )
ロール から "find"
アクションおよび/または"update"
accountRole
アクションを取り消すには、リソース ドキュメントと完全に一致する必要があります。たとえば、次の操作は、既存の特権から"find"
アクションのみを取り消します。
use products db.revokePrivilegesFromRole( "accountRole", [ { resource : { db : "products", collection : "" }, actions : [ "find" ] } ] )
必要なアクセス権
特権を取り消すには、特権ターゲットのデータベースに対してrevokeRole
アクションが必要です。 特権が複数のデータベースまたはcluster
リソースを対象としている場合は、 admin
データベースに対してrevokeRole
アクションが必要です。
例
次の操作により、 associates
ロールから複数の特権が削除されます。
db.revokePrivilegesFromRole( "associate", [ { resource: { db: "products", collection: "" }, actions: [ "createCollection", "createIndex", "find" ] }, { resource: { db: "products", collection: "orders" }, actions: [ "insert" ] } ], { w: "majority" } )