roleInfo
項目一覧
定義
rolesInfo
ユーザー定義ロールと組み込みロールの両方を含む指定されたロールの継承と権限情報を返します。
rolesInfo
コマンドを使用することで、データベースにスコープが設定されているすべてのロールを検索することもできます。
互換性
このコマンドは、次の環境でホストされている配置で使用できます。
MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです
注意
このコマンドは、すべての MongoDB Atlas クラスターでサポートされています。すべてのコマンドに対する Atlas のサポートについては、 「サポートされていないコマンド」を参照してください。
MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン
構文
このコマンドの構文は、次のとおりです。
{ rolesInfo: { role: <name>, db: <db> }, showAuthenticationRestrictions: <Boolean>, showBuiltinRoles: <Boolean>, showPrivileges: <Boolean>, comment: <any> }
コマンドフィールド
このコマンドは、次のフィールドを使用します。
フィールド | タイプ | 説明 |
---|---|---|
rolesInfo | string、ドキュメント、配列、または整数 | に関する情報を返すロール。 ロールを指定するための構文については、「動作 」を参照してください。 |
showAuthenticationRestrictions | ブール値 | 任意。 出力に認証制限を含めるには、このフィールドを デフォルトでは、このフィールドは |
showBuiltinRoles | ブール値 | 任意。 rolesInfo フィールドが1 に設定されている場合は、出力に組み込みロールを含めるために、 showBuiltinRoles をtrue に設定します。 デフォルトでは、このフィールドはfalse に設定されており、 rolesInfo: 1 の出力にはユーザー定義ロールのみが表示されます。 |
showPrivileges | ブール値 | 任意。 フィールドを true に設定すると、他のロールから継承される権限と直接定義された権限の両方を含むロール権限が表示されます。 デフォルトでは、コマンドは、このロールが特権を継承するロールのみを返し、特定の特権は返しません。 |
comment | any | 任意。このコマンドに添付するユーザー指定のコメント。設定すると、このコメントは以下の場所にこのコマンドの記録と合わせて表示されます。
コメントには、有効な BSON 型(string, integer, object, array など)を使用できます。 |
動作
1 つのロールの情報を返す
現在のデータベースからロールを指定するには、次のように、ロールを名前で指定します。
{ rolesInfo: "<rolename>" }
別のデータベースからロールを指定するには、ロールとデータベースを指定するドキュメントでロールを指定します。
{ rolesInfo: { role: "<rolename>", db: "<database>" } }
複数のロールの情報を返す
複数のロールを指定するには、配列を使用します。 配列内の各ロールをドキュメントまたは string として指定します。 コマンドが実行されるデータベースにロールが存在する場合にのみ string を使用します。
{ rolesInfo: [ "<rolename>", { role: "<rolename>", db: "<database>" }, ... ] }
データベース内のすべてのロールの情報を返す
コマンドが実行されるデータベース内のすべてのロールを指定するには、 rolesInfo: 1
を指定します。 デフォルトでは、MongoDB は データベース内のすべてのユーザー定義のロールを表示します。 組み込みロールも含めるには、パラメータと値のペアshowBuiltinRoles: true
を含めます。
{ rolesInfo: 1, showBuiltinRoles: true }
必要なアクセス権
ロールの情報を表示するには、ロールが明示的に付与されているか、ロールのデータベースに対してviewRole
アクションを持っている必要があります。
出力
rolesInfo.db
ロールが定義されているデータベース。 すべてのデータベースには組み込みロール があります。 データベースにはユーザー定義のロールがある場合もあります。
rolesInfo.isBuiltin
true
の値は、ロールが組み込みロール であることを示します。false
の値は、ロールがユーザー定義ロール であることを示します。
rolesInfo.inheritedRoles
このロールが特権を継承するすべてのロール。 これには、
rolesInfo.roles
配列内のロールとrolesInfo.roles
配列内のロールが特権を継承するロールが含まれます。 すべての特権が現在のロールに適用されます。 このフィールドのドキュメントには、ロールと、それが定義されているデータベースが一覧表示されます。
rolesInfo.privileges
このロールによって直接指定される特権。つまり、 配列は他のロールから継承された特権を除外します。 デフォルトでは出力には
privileges
フィールドは含まれません。 フィールドを含めるには、rolesInfo
コマンドを実行するときにshowPrivileges: true
を指定します。
rolesInfo.inheritedPrivileges
他のロールから継承されるものを含む、このロールによって付与されるすべての特権。 デフォルトでは出力には
inheritedPrivileges
フィールドは含まれません。 フィールドを含めるには、rolesInfo
コマンドを実行するときにshowPrivileges: true
を指定します。
例
このセクションの例では、 rolesInfo
コマンドを使用して次の操作を実行する方法を示します。
単一のロールの情報の表示
次のコマンドは、 products
データベースで定義されているロールassociate
のロール継承情報を返します。
db.runCommand( { rolesInfo: { role: "associate", db: "products" } } )
次のコマンドは、コマンドが実行されるデータベース上のロールsiteManager
のロール継承情報を返します。
db.runCommand( { rolesInfo: "siteManager" } )
次のコマンドは、 products
データベースで定義されたロールassociate
のロール継承と特権の両方を返します。
db.runCommand( { rolesInfo: { role: "associate", db: "products" }, showPrivileges: true } )
複数のロールに関する情報の表示
次のコマンドは、2 つの異なるデータベース上の 2 つのロールに関する情報を返します。
db.runCommand( { rolesInfo: [ { role: "associate", db: "products" }, { role: "manager", db: "resources" } ] } )
次の例では、ロールの継承と特権の両方が返されます。
db.runCommand( { rolesInfo: [ { role: "associate", db: "products" }, { role: "manager", db: "resources" } ], showPrivileges: true } )
データベースのすべてのユーザー定義ロールの表示
次の操作は、 コマンドが実行され、 特権を含むデータベース上のすべてのユーザー定義のロールを返します。
db.runCommand( { rolesInfo: 1, showPrivileges: true } )
出力例(読みやすくするために短縮しています)
{ roles: [ { _id: 'products.associate', role: 'associate', db: 'products', privileges: [ { resource: { db: 'products', collection: '' }, actions: [ 'bypassDocumentValidation' ] } ], roles: [ { role: 'readWrite', db: 'products' } ], isBuiltin: false, inheritedRoles: [ { role: 'readWrite', db: 'products' } ], inheritedPrivileges: [ { resource: { db: 'products', collection: '' }, actions: [ 'bypassDocumentValidation' ] }, { resource: { db: 'products', collection: '' }, actions: [ 'changeStream', 'collStats', 'compactStructuredEncryptionData', ... ] }, ... ] } ], ok: 1 }
データベースのすべてのユーザー定義ロールと組み込みロールの表示
次の操作では、組み込みロールとユーザー定義ロールの両方を含む、 コマンドが実行されるデータベース上のすべてのロールが返されます。
db.runCommand( { rolesInfo: 1, showBuiltinRoles: true } )
出力例(読みやすくするために短縮しています)
{ roles: [ { role: 'enableSharding', db: 'products', isBuiltin: true, roles: [], inheritedRoles: [] }, { role: 'userAdmin', db: 'products', isBuiltin: true, roles: [], inheritedRoles: [] }, { role: 'read', db: 'products', isBuiltin: true, roles: [], inheritedRoles: [] }, ... ], ok: 1 }
ロールの認証制限の表示
次の操作は、 products
データベース上のすべてのユーザー定義ロールを返し、認証制限を含みます。
db.runCommand( { rolesInfo: 1, showAuthenticationRestrictions: true } )
出力例:
{ roles: [ { _id: 'products.associate', role: 'associate', db: 'products', roles: [ { role: 'readWrite', db: 'products' } ], authenticationRestrictions: [ [ { clientSource: [ '198.51.100.0' ] } ] ], isBuiltin: false, inheritedRoles: [ { role: 'readWrite', db: 'products' } ], inheritedAuthenticationRestrictions: [ [ { clientSource: [ '198.51.100.0' ] } ] ] } ], ok: 1 }