パブリック プレビュー:フィードバックを提供してください : 指定されたプロジェクトに関連付けられている保留中の MongoDB Cloud ユーザーとアクティブなMongoDB Cloud ユーザーの詳細を返します。
パブリック プレビュー: MongoDB Atlas Admin APIから自動的に生成される Atlas APIサブコマンドは、Admin APIの完全なフィードバックを提供し、現在パブリック プレビュー段階です(フィードバック 930808-Atlas-cli )。管理API機能には独自のリリース ライフサイクルがあり、提供されているAPIエンドポイントのドキュメント リンクから確認できます。
このリソースを使用するには、リクエスト元のサービスアカウントまたはAPIキーにプロジェクトの読み取り専用ロールが必要です。
注: このリソースは、非推奨の「1 人の MongoDB Cloud ユーザーを 1 つのプロジェクトに招待する」エンドポイントとなる接続されたデバイスを介して招待されたユーザーの詳細を表示するために使用することはできません。
注意: 保留中のユーザーとアクティブなユーザーの両方を返すには、v2-{2025-02-19} 以降を使用してください。非推奨のバージョンを使用している場合、アクティブなユーザーのみが帰されます。
このコマンドは自動生成され、1:1 と Atlas APIエンドポイント https://www.mongodb.com/ja-jp/docs/atlas/参照/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/listProjectUsers.
詳細と例については、上記のリンクで参照されているAPIドキュメントを参照してください。
構文
atlas api mongoDbCloudUsers listProjectUsers [options]
オプション
名前 | タイプ | 必須 | 説明 |
---|---|---|---|
-- envelope | envelope | false | アプリケーションが応答をエンベロープJSONオブジェクトでラップするかどうかを示すフラグ。一部のAPIクライアントは、 HTTPレスポンス ヘッダーまたはステータス コードにアクセスできません。これを修正するには、クエリで envelope=true を設定します。結果のリストを返すエンドポイントは、結果オブジェクトをエンベロープとして使用します。アプリケーションは、レスポンス本体にステータス パラメータを追加します。 |
-- flattenTeams | " flattenTeams" : false | false | 返されるリストに、このプロジェクトでロールを持つチームに所属するユーザーを含めるかどうかを示すフラグ。プロジェクトでは、個々のユーザーにはロールが割り当てられていない場合があります。" flattenTeams" : false の場合、このリソースはプロジェクト内でのロールがあるユーザーのみを返します。 |
--groupId | string | true | プロジェクトを識別する一意の 24 桁の 16 進数文字列。 [/groups](# tags/プロジェクト/操作/listProjects) エンドポイントを使用して、認証されたユーザーがアクセスできるすべてのプロジェクトを取得します。 注: グループとプロジェクトは同義語です。そのため、グループ ID はプロジェクト ID と同じです。既存のグループの場合、グループ/プロジェクト ID は同じままです。リソースおよび対応するエンドポイントでは、グループという用語が使用されます。 |
-h, --help | false | listProjectUsers のヘルプ | |
--includeCount | false | レスポンスがレスポンス内のアイテムの総数(totalCount)を返すかどうかを示すフラグ。 | |
--includeOrgUsers | "includeOrgUsers":false | false | 返されるリストに、プロジェクトへの暗黙的なアクセス権を持つユーザー、組織所有者、組織の読み取り専用ロールを含めるかどうかを示すフラグ。プロジェクトでは、個々のユーザーにはロールが割り当てられていない場合があります。"includeOrgUsers":false の場合、このリソースはプロジェクト内でのロールがあるユーザーのみを返します。 |
--itemsPerPage | 整数 | false | レスポンスが返す 1 ページあたりのアイテムの数。 |
--orgMemergeStatus | string | false | 返されるリストをユーザーの組織メンバーシップ ステータスでフィルターするかどうかを示すフラグです。このパラメータを除外すると、このリソースは保留中のユーザーとアクティブなユーザーの両方を返します。非推奨バージョンではサポートされていません。 |
-o, --output | string | false | 優先API形式 は、 ["JSON", go-template] にすることができます。この値のデフォルトは "JSON" です。 |
-- outputFile | string | false | API 出力を書き込むファイル。このフラグは、エンドポイントの出力がバイナリ(例: gzip)で、コマンドがパイプライン化されていない場合(例: Atlas コマンド >out.zip)に必要です。 |
--pageNum | 整数 | false | レスポンスが返す合計オブジェクト数の現在のセットを表示するページの番号。 |
--pretty | false | レスポンス本体を pretty-print 形式にするかどうかを示すフラグ。 | |
--username | string | false | ユーザーをフィルターするためのメール アドレスです。非推奨バージョンではサポートされていません。 |
--version | string | false | API 呼び出しで使用する API バージョン [options: "2023-01-01", "2025-02-19"] は、デフォルトで最新バージョンまたはプロファイル api_version設定されている場合の構成値この値はデフォルトで "2025-02-19" になります。 |
継承されたオプション
名前 | タイプ | 必須 | 説明 |
---|---|---|---|
-P, --profile | string | false | 構成ファイルから使用するプロファイルの名前。Atlas CLI のプロファイルの詳細については、https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. を参照してください。 |
例
atlas api mongoDbCloudUsers listProjectUsers --version 2025-02-19 --groupId 32b6e34b3d91647abb20e7b8 --orgMembershipStatus ACTIVE