ホスト名とポートによる 1 つのホストの取得
Cloud Manager は、 2024年8月30日でMongoDB 3.6と4.0のオートメーション、バックアップおよびモニタリングのサポートを終了します。 MongoDB の配置をアップグレードするか、Atlas に移行してください。
- Cloud Managerへのプログラムによるアクセスのための OAuth 2.0認証はプレビュー機能として利用できます。
- 機能および関連するドキュメントは、プレビュー期間中にいつでも変更される可能性があります。 OAuth2.0 認証を使用するには、 Cloud Manager Public APIへのリクエストで使用する サービス アカウント を作成します。
注意
グループとプロジェクトは同義語です。 あなたの {PROJECT-ID}はプロジェクト ID と同じです。 既存のグループの場合、グループ/プロジェクト ID は同じままです。 このページでは、説明を参照するときに、より一般的な用語の グループ を使用します。 エンドポイントは ドキュメントに記載されているままです。
ホスト名とポートの組み合わせによって、単一の MongoDB プロセスを取得します。 プライマリ ホスト名または エイリアスのいずれかを指定できます。
ベース URL: https://cloud.mongodb.com/api/public/v 1.0
Resource
GET /groups/{PROJECT-ID}/hosts/byName/{HOSTNAME}:{PORT}
リクエスト パス パラメーター
Parameter | タイプ | 必要性 | 説明 |
|---|---|---|---|
プロジェクトID | string | 必須 | この MongoDB プロセスを所有するプロジェクトの一意の識別子。 |
Hostname | string | 必須 | Cloud Manager がこの MongoDB インスタンスに接続するために使用するプライマリ ホスト名。 このホスト名は、ホスト名、 FQDN 、 IPv4アドレス、またはIPv6アドレスにすることができます。 |
ポート | string | 必須 | MongoDB プロセスが listen するポート。 |
リクエスト クエリ パラメータ
次のクエリ パラメータは 任意です。
名前 | タイプ | 必要性 | 説明 | default | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
pretty | ブール値 | 任意 | レスポンス本体を pretty-print にするかどうかを示すフラグ 形式。 | false | ||||||
envelope | ブール値 | 任意 | 応答をエンベロープでラップするかどうかを示すフラグ。 一部のAPIクライアントは、 HTTPレスポンス ヘッダーまたはステータス コードにアクセスできません。 これを修正するには、クエリでenvelope=trueを設定します。 1 つの結果を返すエンドポイントの場合、レスポンス本体には次のものが含まれます。
| false |
リクエスト ボディ パラメータ
このエンドポイントは、HTTP リクエスト本体パラメータを使用しません。
応答
名前 | タイプ | 説明 |
|---|---|---|
aliases | 文字列の配列 | Cloud Manager が MongoDB プロセスのために検出したホスト名とポートの代替組み合わせの配列。 これらの組み合わせには、ホスト名、 FQDN 、 IPv4アドレス、およびIPv6アドレスが含まれます。 |
alertsEnabled | ブール値 | true この MongoDB プロセスで アラートが有効になっている場合 |
authMechanismName | string | この MongoDB プロセスに接続するために使用される認証メカニズム。 これには、次のいずれかの値のみが表示されます。
|
clusterId | string | MongoDB プロセスが属するクラスターのユニーク識別子です。 |
作成済み | date | Cloud Manager がこの MongoDB プロセスを作成または最初に検出した日付。 |
グループ ID | string | このホストを所有するグループの一意の識別子。 |
hasStartupServings | ブール値 | true この MongoDB プロセスに起動時の警告があった場合、 。 |
hidden | ブール値 | true Cloud Manager UI にホストが表示されている場合。 trueに設定されたホストはAPI応答から省略されます。 |
hiddenSecondary | ブール値 | true このホストが非表示のセカンダリ である場合。 |
hostEnabled | ブール値 | true MongoDB プロセスが現在有効になっている場合。 |
Hostname | string | Cloud Manager が決定できるプライマリ ホスト名。 これは、ホスト名、 FQDN 、 IPv4アドレス、またはIPv6アドレスにすることができます。 |
id | string | Unique identifier. |
ipAddress | string | この MongoDB プロセスの hostnameに関連付けられているIPv4アドレスまたはIPv6アドレス。 追加のアクセス可能なIPv4またはIPv6アドレスはaliases配列に表示される場合があります。 |
journalingEnabled | ブール値 | true この MongoDB プロセスでジャーナリングが有効になっている場合は 。 |
lastDataSizeBytes | 数値 | ディスク上のホストのデータベースの非圧縮サイズ（インデックスを除く）。 lastDataSizeBytesには ローカル データベース内のデータは含まれ ません 。 |
lastIndexSizeBytes | 数値 | ディスク上のホストのデータベース インデックスの非圧縮サイズ（バイト単位）。 この数には ローカル データベースのインデックスのサイズは含まれ ません 。 |
lastPing | date | ISO8601 のタイムスタンプ この MongoDB プロセスの最後の ping が受信されたとき、 UTC で表された日付と時刻形式。 |
lastRestart | date | ISO8601 のタイムスタンプ このプロセスが最後に再起動されたときの日付と時刻形式（ UTC） 。MongoDB プロセスが再起動されていない場合、 lastRestartフィールドは省略されます。 |
Links | 配列 | サブリソースや関連リソースへの 1 つ以上のリンクを含む配列。 URL の関係は、 Web リンク仕様 で説明されています 。少なくとも、 links配列にはselfと呼ばれる 1 つのリンクが含まれています。 |
logsEnabled | ブール値 | true Cloud Manager がこの MongoDB プロセスのログを収集している場合は、。 |
slowUlimit | ブール値 | true この MongoDB プロセスのホストのulimit設定が低い場合。 |
ポート | 数値 | MongoDB プロセスが listen するポート。 |
profileEnabled | ブール値 | true Cloud Manager がこの MongoDB プロセスからプロファイル情報を収集する場合。 |
ReplicaSetName | string | このプロセスが属するレプリカセットの名前。 このプロセスがレプリカセットの一部である場合にのみ存在します。 |
replicaStateName | string | レプリカセット内のこの MongoDB プロセスの現在の状態。 このプロセスがレプリカセットの一部である場合にのみ存在します。 可能な値については、「レプリカセット ノードの状態 」を参照してください。 |
shardName | string | このプロセスが属するシャードの名前。 プロセスがシャーディングされたクラスターの一部である場合にのみ存在します。 |
secondaryDelaySecs | 数値 | このレプリカセットメンバーのデータがプライマリより続く秒数。 この値が 0に設定されている場合、ノードは 遅延ノード として構成されません。 セカンダリ遅延の詳細については、「遅延レプリカセット ノード」を参照してください |
sslEnabled | ブール値 | true この MongoDB プロセスでTLS / SSLおよび が有効になっている場合。 |
systemInfo | オブジェクト | オペレーティング システムまたはコンテナによって報告される、この MongoDB プロセスのサーバーの RAM および CPU 情報を含むオブジェクト。 |
systemInfo.memSizeMB | 数値 | RAM の量（メガバイト単位）。 |
systemInfo.numCores | 数値 | CPU コアの数。 |
typeName | string | この MongoDB プロセスのタイプ。 可能な値は次のとおりです。
Cloud Manager に追加された新しいホストのタイプは、モニタリングが最初の ping を受信するまで |
uptimeMsec | 数値 | このプロセスが最後に再起動されてからのミリ秒数。 |
バージョン | string | このプロセスで実行されている MongoDB のバージョン。 |
リクエストの例
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --include \ --request GET "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/hosts/byName/server1.example.com:27017?pretty=true"
応答例
応答ヘッダー
401 Unauthorized Content-Type: application/json;charset=ISO-8859-1 Date: {dateInUnixFormat} WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false Content-Length: {requestLengthInBytes} Connection: keep-alive
200 OK Vary: Accept-Encoding Content-Type: application/json Strict-Transport-Security: max-age=300 Date: {dateInUnixFormat} Connection: keep-alive Content-Length: {requestLengthInBytes} X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}
レスポンス本体
1 { 2 "alertsEnabled" : true, 3 "aliases": [ "server1.example.com:27017", "10.1.0.10:27017" ], 4 "authMechanismName" : "SCRAM-SHA-1", 5 "clusterId" : "{CLUSTER-ID}", 6 "created" : "2014-04-22T19:56:50Z", 7 "groupId" : "{PROJECT-ID}", 8 "hasStartupWarnings" : false, 9 "hidden" : false, 10 "hostEnabled" : true, 11 "hostname" : "server1.example.com", 12 "id" : "{HOST-ID}", 13 "ipAddress": "10.1.0.10", 14 "journalingEnabled" : false, 15 "lastDataSizeBytes" : 633208918, 16 "lastIndexSizeBytes" : 101420524, 17 "lastPing" : "2016-08-18T11:23:41Z", 18 "links" : [ ], 19 "logsEnabled" : false, 20 "lowUlimit" : false, 21 "muninEnabled" : false, 22 "port" : 27017, 23 "profilerEnabled" : false, 24 "replicaSetName": "rs1", 25 "replicaStateName" : "PRIMARY", 26 "sslEnabled" : true, 27 "systemInfo" : { 28 "memSizeMB" : 65536, 29 "numCores" : 16 30 }, 31 "typeName": "REPLICA_PRIMARY", 32 "uptimeMsec": 1827300394, 33 "username" : "mongodb", 34 "version" : "4.0.0" 35 }
注意
Cloud Manager はレスポンスで MongoDB Ops Manager を返しますが、 Monin はサポートされていません。