AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

グローバル アプリ設定を取得する

MongoDB Ops Manager インストールのグローバル アプリケーション設定を取得します。

このエンドポイントとなる接続されたデバイスを正常に呼び出すには、ユーザーの API キーに Global Owner ロールが必要です。

ベース URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0

GET /admin/settings

このエンドポイントは、HTTP リクエスト パス パラメーターを使用しません。

名前
タイプ
必要性
説明
default

pretty

ブール値

任意

レスポンス本体をpretty-print形式にするかどうかを示すフラグ。

false

envelope

ブール値

任意

応答をエンベロープでラップするかどうかを示すフラグ。

一部の API クライアントは、HTTP レスポンス ヘッダーまたはステータス コードにアクセスできません。これを修正するには、クエリで envelope=true を設定します。

1 つの結果を返すエンドポイントの場合、レスポンス本体には次のものが含まれます。

  • status: HTTPレスポンス コード

  • content: 期待される応答本体

false

このエンドポイントは、HTTP リクエスト本体パラメータを使用しません。

フィールド
タイプ
説明

dbProperties

オブジェクト

データベースに保存されているグローバルアプリ設定のキーと値のペア。MongoDB Ops Manager は、機密設定をプレーンテキストで返しません。

defaultFileProperties

オブジェクト

MongoDB Ops Manager にバンドルされているデフォルト構成ファイルからのキー値ペア。これらの設定は、インスタンスレベルの構成上書きファイルとは異なります。

instanceOverrides

オブジェクト

インスタンスごとのデータベースの上書き設定。これらの設定は公開 API を使用して読み取ることはできますが、更新することはできません。

instanceDetails

オブジェクト

インスタンスレベルのデータベースオーバーライドに関連付けられたインスタンスの詳細。

secretProperties

文字列の配列

MongoDB Ops Manager がデータベースに暗号化された値として保存する設定の名前。このリストの内容は、将来のリリースで変更される可能性があります。

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --include \ --request GET \ "https://<OpsManagerHost>:<Port>/api/public/v1.0/admin/settings?pretty=true"
HTTP/1.1 401 UnauthorizedContent-Type: application/json;charset=ISO-8859-1Date: {dateInUnixFormat}WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=falseContent-Length: {requestLengthInBytes}Connection: keep-alive
HTTP/1.1 200 OKVary: Accept-EncodingContent-Type: application/jsonStrict-Transport-Security: max-age=300Date: {dateInUnixFormat}Connection: keep-aliveContent-Length: {requestLengthInBytes}X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}
{ "dbProperties": { "mms.centralUrl": "https://ops-manager.example.com", "mms.https.CAFile": "/path/to/ca/file" }, "defaultFileProperties": { "mms.https.ClientCertificateMode": "none" }, "instanceOverrides": { "instance-1": { "reCaptcha.enabled.registration": "false" } }, "instanceDetails": { "instance-1": { "om.instance.runtime.availableProcessors": 2 } }, "secretProperties": [ "mms.smtp.password" ]}