Docs Menu
Docs Home
/
MongoDB Ops Manager
/
API
/
リソース
/
配置
/
ホスト

ID でホストを取得

項目一覧

  • Resource
  • リクエスト パス パラメーター
  • リクエスト クエリ パラメータ
  • リクエスト ボディ パラメータ
  • 応答
  • リクエストの例
  • 応答例
  • 応答ヘッダー
  • レスポンス本体

注意

グループとプロジェクトは同義語です。 あなたの {PROJECT-ID}はプロジェクト ID と同じです。 既存のグループの場合、グループ/プロジェクト ID は同じままです。 このページでは、説明を参照するときに、より一般的な用語の グループ を使用します。 エンドポイントは ドキュメントに記載されているままです。

指定されたホスト ID を持つ MongoDB プロセスを取得します。

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

Resource

GET /groups/{PROJECT-ID}/hosts/{HOST-ID}

リクエスト パス パラメーター

Parameter
タイプ
必要性
説明

プロジェクトID

string

必須

この MongoDB プロセスを所有するプロジェクトの一意の識別子。

ホスト ID

string

必須

MongoDB プロセスのホストの一意の識別子です。

リクエスト クエリ パラメータ

次のクエリ パラメータは 任意です。

名前
タイプ
必要性
説明
default

pretty

ブール値

任意

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

false

envelope

ブール値

任意

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

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

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

名前
説明

status

HTTPレスポンス コード

content

期待される応答本体

false

リクエスト ボディ パラメータ

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

応答

名前
タイプ
説明

aliases

文字列の配列

MongoDB プロセスのために MongoDB Ops Manager が検出したホスト名とポートの代替組み合わせの配列。 これらの組み合わせには、ホスト名、 FQDN 、 IPv4アドレス、およびIPv6アドレスが含まれます。

alertsEnabled

ブール値

true この MongoDB プロセスで アラートが有効になっている場合

authMechanismName

string

この MongoDB プロセスに接続するために使用される認証メカニズム。 これには、次のいずれかの値のみが表示されます。

  • MONGODB_CR （これは SCRAM-SHA-1、SCRAM-SHA-256、MONGODB-CR をカバーします。）

  • GSSAPI

  • PLAIN

  • MONGODB_X509

  • NONE

clusterId

string

MongoDB プロセスが属するクラスターのユニーク識別子です。

作成済み

date

MongoDB Ops Manager がこの MongoDB プロセスを作成または最初に検出した日付。

グループ ID

string

このホストを所有するグループの一意の識別子。

hasStartupServings

ブール値

true この MongoDB プロセスに起動時の警告があった場合、 。

hidden

ブール値

true ホストが MongoDB Ops Manager UI に表示されている場合。 trueに設定されたホストはAPI応答から省略されます。

hiddenSecondary

ブール値

true このホストが非表示のセカンダリ である場合。

hostEnabled

ブール値

true MongoDB プロセスが現在有効になっている場合。

Hostname

string

MongoDB Ops 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 MongoDB Ops Manager がこの MongoDB プロセスのログを収集している場合は、。

slowUlimit

ブール値

true この MongoDB プロセスのホストのulimit設定が低い場合。

ポート

数値

MongoDB プロセスが listen するポート。

profileEnabled

ブール値

true MongoDB Ops 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 プロセスのタイプ。 可能な値は次のとおりです。

  • STANDALONE

  • REPLICA_PRIMARY

  • REPLICA_SECONDARY

  • REPLICA_ARBITER

  • RECOVERING

  • SHARD_MONGOS

  • SHARD_CONFIG

  • SHARD_STANDALONE

  • SHARD_PRIMARY

  • SHARD_SECONDARY

  • NO_DATA

MongoDB Ops Manager に追加された新しいホストのタイプは、モニタリングが最初の ping を受信するまでNO_DATAになります。

uptimeMsec

数値

このプロセスが最後に再起動されてからのミリ秒数。

バージョン

string

このプロセスで実行されている MongoDB のバージョン。

リクエストの例

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
 --header "Accept: application/json" \
 --include \
 --request GET "https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/groups/{PROJECT-ID}/hosts/{HOST-ID}?pretty=true"

応答例

応答ヘッダー

HTTP/1.1 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
HTTP/1.1 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" : "MONGODB_CR",
5  "clusterId" : "{CLUSTER-ID}",
6  "created" : "2024-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" : "2024-08-18T11:23:41Z",
18  "links" : [  ],
19  "logsEnabled" : false,
20  "lowUlimit" : false,
21  "port" : 27017,
22  "profilerEnabled" : false,
23  "replicaSetName": "rs1",
24  "replicaStateName" : "PRIMARY",
25  "sslEnabled" : true,
26  "systemInfo" : {
27    "memSizeMB" : 65536,
28    "numCores" : 16
29  },
30  "typeName": "REPLICA_PRIMARY",
31  "uptimeMsec": 1827300394,
32  "username" : "mongodb",
33  "version" : "4.4.0"
34}

戻る

すべて取得

次へ

ホスト名とポートによる取得