Docs Menu
Docs Home
/
MongoDBマニュアル
/ / /

connectionStatus

項目一覧

  • 定義
  • 互換性
  • 構文
  • 出力
connectionStatus

現在の接続に関する情報、具体的には認証されたユーザーの状態と使用可能な権限を返します。

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

  • MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです

注意

このコマンドは、すべての MongoDB Atlas クラスターでサポートされています。すべてのコマンドに対する Atlas のサポートについては、「サポートされていないコマンド」を参照してください。

  • MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン

  • MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

このコマンドの構文は、次のとおりです。

db.runCommand(
{
connectionStatus: 1,
showPrivileges: <boolean>
}
)

connectionStatus 次のオプション フィールドをサポートします。

フィールド
タイプ
説明

showPrivileges

ブール値

任意。 showPrivilegesを true に設定すると、connectionStatus に、現在認証されているユーザーが所有する権限の完全なセットを返すように指示します。

デフォルトでは、このフィールドは false です。

connectionStatusを実行するには、次のようにdb.runCommand()メソッドを使用します。

db.runCommand( { connectionStatus: 1, showPrivileges: true } )
connectionStatus.authInfo

ユーザーや利用可能な権限など、現在の接続の認証状態に関するデータを含むドキュメント。

connectionStatus.authinfo.authenticatedUsers

認証された各ユーザーのドキュメントを含む配列。

connectionStatus.authInfo.authenticatedUsers[n].user

ユーザー名。

connectionStatus.authInfo.authenticatedUsers[n].db

ユーザーの認証情報に関連付けられているデータベース。

connectionStatus.authinfo.authenticatedUserRoles

現在の接続に付与されている各ロールのドキュメントを含む配列:

connectionStatus.authinfo.authenticatedUserRoles[n].role

現在認証されているユーザーに関連付けられている現在のロールの定義。 詳しくは、「 自己管理型配置の組み込みロール 」および「 自己管理型配置権限アクション 」を参照してください。

connectionStatus.authinfo.authenticatedUserRoles[n].db

role が適用されるデータベース。

connectionStatus.authInfo.authenticatedUserPrivileges

現在の接続に許可されているアクションを説明するドキュメントの配列。リソースごとにグループ化されています。

connectionStatus.authInfo.authenticatedUserPrivileges[n].resource

connectionStatus.authInfo.authenticatedUserPrivileges[n].actions が適用されるデータベースと、該当する場合はコレクションを説明するドキュメント。

connectionStatus.authInfo.authenticatedUserPrivileges[n].actions

指定されたリソースに対して接続がアクセスできる権限アクションをリストする配列。

connectionStatus.ok

コマンドの戻り値です。値が1の場合は成功を示します。

戻る

connPoolStats