grantPrivilegesToRole（データベースコマンド）

定義

grantPrivilegesToRole

コマンドが実行されるデータベースで定義されたユーザー定義のロールに追加の権限を割り当てます。

Tip

In mongosh, this command can also be run through the db.grantPrivilegesToRole() helper method.

Helper methods are convenient for mongosh users, but they may not return the same level of information as database commands. In cases where the convenience is not needed or the additional return fields are required, use the database command.

The grantPrivilegesToRole command uses the following syntax:

db.runCommand(
   {
     grantPrivilegesToRole: "<role>",
     privileges: [
       {
         resource: { <resource> }, actions: [ "<action>", ... ]
       },
       ...
     ],
     writeConcern: { <write concern> },
     comment: <any>
   }
)

互換性

このコマンドは、次の環境でホストされている配置で使用できます。

MongoDB Atlas はクラウドでの MongoDB 配置のための完全管理サービスです

重要

このコマンドは、M0 および Flex クラスターではサポートされていません。詳細については、サポートされていないコマンドを参照してください。

MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

コマンドフィールド

コマンドには次のフィールドがあります:

フィールド	タイプ	説明
`grantPrivilegesToRole`	string	特権を付与するユーザー定義ロールの名前。
`privileges`	配列	ロールに追加する特権。権限の形式については、 `privileges`を参照してください。
`writeConcern`	ドキュメント	任意。操作の書込み保証（ write concern ）のレベル。詳しくは、書込み保証（write concern）の仕様を参照してください。
`comment`	any	任意。このコマンドに添付するユーザー指定のコメント。設定すると、このコメントは以下の場所にこのコマンドの記録と合わせて表示されます。 `attr.command.cursor.comment` フィールド内のmongod ログメッセージ。 `command.comment` フィールドのデータベースプロファイラー出力。 `command.comment` フィールドの`currentOp`出力。コメントには、有効な BSON 型（string, integer, object, array など）を使用できます。

動作

ロールの特権は、ロールが作成されたデータベースに適用されます。 adminデータベースで作成されたロールには、すべてのデータベースまたはクラスターに適用する特権を含めることができます。

必要なアクセス権

特権を付与するには、特権ターゲットのデータベースに対してgrantRoleアクションが必要です。複数のデータベースまたはclusterリソースに特権を付与するには、 adminデータベースに対してgrantRoleアクションが必要です。

例

The following grantPrivilegesToRole command grants two additional privileges to the service role that exists in the products database:

use products
db.runCommand(
   {
     grantPrivilegesToRole: "service",
     privileges: [
         {
           resource: { db: "products", collection: "" }, actions: [ "find" ]
         },
         {
           resource: { db: "products", collection: "system.js" }, actions: [ "find" ]
         }
     ],
     writeConcern: { w: "majority" , wtimeout: 5000 }
   }
)

privileges配列の最初の特権により、ユーザーはproductsデータベース内のすべての非システムコレクションを検索できます。特権では、コレクションなどの system.js システムコレクションに対するクエリは許可されません。これらのシステムコレクションへのアクセスを許可するには、 privileges配列でアクセスを明示的にプロビジョニングします。自己管理型配置に関するリソースドキュメントを参照してください。

2find system.js番目の特権は、すべてのデータベース上のコレクションに対するアクションを明示的に許可します。

戻る

dropAllRolesFromDatabase

grantRolesToRole