Performance Advisor が提案するインデックスを返します。パフォーマンス アドバイザーは、MongoDB が遅いと判断したクエリを監視し、クエリ パフォーマンスを向上させるための新しいインデックスを提案します。
プロジェクトを識別する一意の 24 桁の 16 進数文字列。 認証済みユーザーがアクセスできるすべてのプロジェクトを取得するには、 /groups エンドポイントを使用します。
注: グループとプロジェクトは同義語です。そのため、グループ ID はプロジェクト ID と同じです。既存のグループの場合、グループ/プロジェクト ID は同じままです。リソースおよび対応するエンドポイントでは、グループという用語が使用されます。
形式は次のパターンと一致する必要があります: ^([a-f0-9]{24})$。
MongoDB プロセスを提供するホストとポートの組み合わせ。ホストは、MongoDB プロセス（mongodまたはmongos）を実行するホストのホスト名、FQDN、IPv4 アドレス、または IPv6 アドレスである必要があります。ポートは MongoDB プロセスがリクエストをリッスンする IANA ポートである必要があります。
形式は次のパターンと一致する必要があります: ^([0-9]{1,3}\.){3}[0-9]{1,3}|([0-9a-f]{1,4}\:){7}([0-9a-f]{1,4})|(([a-z0-9]+\.){1,10}[a-z]+)?(\:[0-9]{4,5})$。
アプリケーションがレスポンスを envelope JSON オブジェクトにラップするかどうかを示すフラグ。一部の API クライアントは、HTTP レスポンス ヘッダーまたはステータス コードにアクセスできません。これを修正するには、クエリで envelope=true を設定します。結果のリストを返すエンドポイントは、結果オブジェクトをエンベロープとして使用します。アプリケーションは、レスポンス本体にステータス パラメータを追加します。
デフォルト値はfalseです。
MongoDB Cloud が応答の項目の総数を計算するかどうかを示すフラグ。 false に設定すると、 MongoDB Cloud は追加のカウント操作をスキップする可能性があります。追加の計算なしでカウントが利用可能な場合でも、応答には totalCount が含まれることがあります。
デフォルト値はtrueです。
レスポンスが返す 1 ページあたりのアイテムの数。
最小値は 1、最大値は 500 です。デフォルト値は 100 です。
レスポンスが返す合計オブジェクト数の現在のセットを表示するページの番号。
の最小値は 1 です。デフォルト値は 1 です。
レスポンス本体を pretty-print 形式にするかどうかを示すフラグ。
デフォルト値はfalseです。
クエリがクラスター内の管理対象名前空間から推奨インデックスを検索する時間の長さ。このパラメータは、その値をミリ秒単位で表します。
推奨されたインデックスを検索する名前空間。名前空間は 1 件のデータベースと 1 件のコレクション リソースで構成され、.: <database>.<collection> と記述されます。複数の名前空間を含めるには、各名前空間の間をアンパサンド (&) で区切って、パラメーターを複数回渡します。このパラメーターを省略すると、すべての名前空間の結果が返されます。
推奨インデックスの恩恵を受けるクエリ例の最大数。
デフォルト値は5です。
推奨するインデックスの最大数を示す数値。
クエリが推奨インデックスを取得する日時。このパラメータは、 UNIXエポックから経過したミリ秒数で値を表します。
の最小値は 1199145600000 です。
curl \
--request GET 'https://cloud.mongodb.com/api/atlas/v1.0/groups/32b6e34b3d91647abb20e7b8/processes/{processId}/performanceAdvisor/suggestedIndexes' \
--header "Authorization: Bearer $ACCESS_TOKEN"{
"shapes": [
{
"avgMs": 42,
"count": 42,
"id": "32b6e34b3d91647abb20e7b8",
"inefficiencyScore": 42,
"namespace": "string",
"operations": [
{
"predicates": [
{}
],
"raw": "{\"t\":{\"$date\":\"2026-08-17T22:04:15.133+00:00\"},\"s\":\"I\",\"c\":\"COMMAND\",\"id\":51803,\"ctx\":\"conn0\",\"msg\":\"Slow query\",\"attr\":{\"type\":\"command\",\"ns\":\"<db>.<collection>\",\"command\":{\"find\":\"<collection>\",\"filter\":{\"<field>\":\"<value>\"},\"$db\":\"<db>\"},\"planSummary\":\"COLLSCAN\",\"keysExamined\":0,\"docsExamined\":10000,\"nreturned\":1,\"remote\":\"<client>\",\"durationMillis\":108}}",
"stats": {
"ms": 42,
"nReturned": 42,
"nScanned": 42,
"ts": 42
}
}
]
}
],
"suggestedIndexes": [
{
"avgObjSize": 42.0,
"collation": {},
"id": "32b6e34b3d91647abb20e7b8",
"impact": [
"string"
],
"index": [
{
"additionalProperty1": 1,
"additionalProperty2": 1
}
],
"namespace": "string",
"weight": 42.0
}
]
}{
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"error": 401,
"errorCode": "NOT_ORG_GROUP_CREATOR",
"reason": "Unauthorized"
}{
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"error": 403,
"errorCode": "CANNOT_CHANGE_GROUP_NAME",
"reason": "Forbidden"
}{
"detail": "(This is just an example, the exception may not be related to this endpoint) Cannot find resource AWS",
"error": 404,
"errorCode": "RESOURCE_NOT_FOUND",
"reason": "Not Found"
}{
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"error": 429,
"errorCode": "RATE_LIMITED",
"reason": "Too Many Requests"
}{
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"error": 500,
"errorCode": "UNEXPECTED_ERROR",
"reason": "Internal Server Error"
}