パブリック プレビュー: にフィードバックを提供してください: アクセス可能な特定のプロジェクトのすべてのクラスターの詳細を返します。
クラスターには、同じデータセットを維持するホストのグループが含まれます。レスポンスには、非対称サイズのシャードがあるクラスターが含まれます。このリソースを使用するには、リクエスト元の API キーにプロジェクトの読み取り専用ロールが必要です。この機能はサーバーレス クラスターでは利用できません。
このエンドポイントは、 createCluster エンドポイントを使用して作成された Flex クラスター、または 1 月2026まで Flex クラスターに移行された以前の M2/M5 クラスターでも使用できます。代わりに、Flex クラスターには listFlexClusters エンドポイントを使用してください。
このコマンドは自動生成され、:1 と1 Atlas APIエンドポイント https://www.mongodb.com/ja-jp/docs/atlas/ 参照/api-resources-spec/v2 /# tags/Clusters/ /listClusters の操作。
詳細と例については、上記のリンクで参照されているAPIドキュメントを参照してください。
構文
atlas api clusters listClusters [options]
オプション
名前 | タイプ | 必須 | 説明 |
---|---|---|---|
-- envelope | envelope | false | アプリケーションが応答をエンベロープJSONオブジェクトでラップするかどうかを示すフラグ。一部のAPIクライアントは、 HTTPレスポンス ヘッダーまたはステータス コードにアクセスできません。これを修正するには、クエリで envelope=true を設定します。結果のリストを返すエンドポイントは、結果オブジェクトをエンベロープとして使用します。アプリケーションは、レスポンス本体にステータス パラメータを追加します。 |
--groupId | string | true | プロジェクトを識別する一意の 24 桁の 16 進数文字列。 [/groups](# tags/プロジェクト/操作/listProjects) エンドポイントを使用して、認証されたユーザーがアクセスできるすべてのプロジェクトを取得します。 注: グループとプロジェクトは同義語です。そのため、グループ ID はプロジェクト ID と同じです。既存のグループの場合、グループ/プロジェクト ID は同じままです。リソースおよび対応するエンドポイントでは、グループという用語が使用されます。 |
-h, --help | false | listClusters のヘルプ | |
--includeCount | false | レスポンスがレスポンス内のアイテムの総数(totalCount)を返すかどうかを示すフラグ。 | |
--includeDeletedWithRetainedBackups | false | バックアップを保持するクラスターを返すかどうかを示すフラグ。 | |
--itemsPerPage | 整数 | false | レスポンスが返す 1 ページあたりのアイテムの数。 |
--出力 | string | false | 優先API形式 は、 ["JSON", go-template] にすることができます。この値のデフォルトは "JSON" です。 |
-- output-file | string | false | API 出力を書き込むファイル。このフラグは、エンドポイントの出力がバイナリ(例: gzip)で、コマンドがパイプライン化されていない場合(例: Atlas コマンド >out.zip)に必要です。 |
--pageNum | 整数 | false | レスポンスが返す合計オブジェクト数の現在のセットを表示するページの番号。 |
--pretty | false | ||
--version | string | false | API呼び出しで使用するAPIバージョン [options: "2023-01-01", "2023-02-01", "2024-08-05"] は、最新バージョンにデフォルト設定されているか、設定されている場合は api_version 構成値をプロファイリングします。この値のデフォルトは "2024-08-05" です。 |
継承されたオプション
名前 | タイプ | 必須 | 説明 |
---|---|---|---|
-P, --profile | string | false | 構成ファイルから使用するプロファイルの名前。Atlas CLI のプロファイルの詳細については、 https://docub.mongodb.org/core/atlas-cli-save- connection-settings を参照してください。 |
例
指定されたプロジェクト内のすべてのクラスターを返します
以下の コマンドを実行します。
atlas api clusters listClusters --version 2024-08-05 --envelope false --groupId [your-project-id] --includeCount true --itemsPerPage 100 --pageNum 1 --pretty false