1 つの監視対象ホストの構成を更新

項目一覧

Resource

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

注意

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

監視対象の MongoDB プロセスの構成を更新します。

ベースURL: https:// クラウド.mongodb.com/api/public/v 1.0

Resource

PATCH /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

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

Parameter	タイプ	必要性	説明
alertsEnabled	ブール値	任意	この MongoDB プロセスでアラートを有効にする必要がある場合は、 `true`に設定します。
authMechanismName	string	任意	この MongoDB プロセスに接続するために使用する認証メカニズムを指定します。可能な値は次のとおりです。 `MONGODB_CR` （これは SCRAM-SHA-1、SCRAM-SHA-256、MONGODB-CR をカバーします。） `GSSAPI` `PLAIN` `MONGODB_X509` `NONE`
logsEnabled	ブール値	任意	Cloud Manager がこの MongoDB プロセスのログを収集する必要がある場合は、 `true`に設定します。
パスワード	string	条件付き	この MongoDB プロセスに接続するためのパスワード。 `"authMechanismName" : "MONGODB_CR"`または`"authMechanismName" : "SCRAM_SHA_1"`の場合はを指定します。ただし、ホストエンティティが返されたときに公開されることはありません。
profileEnabled	ブール値	任意	Cloud Manager がこの MongoDB プロセスからプロファイル情報を収集する場合は、 `true`に設定します。
sslEnabled	ブール値	条件付き	この MongoDB プロセスでTLS / SSLを有効にする必要がある場合は、 `true`に設定します。 `true`の場合は`"authMechanismName" : "MONGODB_X509"` に設定します。
username	string	条件付き	この MongoDB プロセスに接続するために必要なユーザー名。 `"authMechanismName" : "MONGODB_CR"`または`"authMechanismName" : "SCRAM_SHA_1"`の場合はを指定します。

authMechanismNameがNONEの場合、ユーザー名とパスワードの既存の値はすべてクリアされます。 authMechanismNameがSCRAM-SHA-1の場合、ユーザー名とパスワードの両方を指定する必要があります。

応答

名前	タイプ	説明
aliases	文字列の配列	Cloud Manager が MongoDB プロセスのために検出したホスト名とポートの代替組み合わせの配列。これらの組み合わせには、ホスト名、 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	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 プロセスのタイプ。可能な値は次のとおりです。 `STANDALONE` `REPLICA_PRIMARY` `REPLICA_SECONDARY` `REPLICA_ARBITER` `RECOVERING` `SHARD_MONGOS` `SHARD_CONFIG` `SHARD_STANDALONE` `SHARD_PRIMARY` `SHARD_SECONDARY` `NO_DATA` Cloud Manager に追加された新しいホストのタイプは、モニタリングが最初の ping を受信するまで`NO_DATA`になります。
uptimeMsec	数値	このプロセスが最後に再起動されてからのミリ秒数。
バージョン	string	このプロセスで実行されている MongoDB のバージョン。

リクエストの例

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Accept: application/json" \
     --header "Content-Type: application/json" \
     --include \
     --request PATCH "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/hosts/{HOST-ID}?pretty=true" \
     --data '
       {
         "sslEnabled": true,
         "username": "mongodb",
         "password": "M0ng0DB!:)"
       }'

応答例

応答ヘッダー

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   "authMechanismName" : "SCRAM-SHA-1",
4   "clusterId" : "{CLUSTER-ID}",
5   "created" : "2014-04-22T19:56:50Z",
6   "groupId" : "{PROJECT-ID}",
7   "hasStartupWarnings" : false,
8   "hidden" : false,
9   "hostEnabled" : true,
10   "hostname" : "server1.example.com",
11   "id" : "{HOST-ID}",
12   "ipAddress": "10.1.0.10",
13   "journalingEnabled" : false,
14   "lastDataSizeBytes" : 470208719,
15   "lastIndexSizeBytes" : 110420592,
16   "lastPing" : "2016-08-15T17:57:12Z",
17   "links" : [  ],
18   "logsEnabled" : false,
19   "lowUlimit" : false,
20   "muninEnabled" : false,
21   "port" : 26000,
22   "profilerEnabled" : false,
23   "replicaSetName": "rs1",
24   "replicaStateName" : "SECONDARY",
25   "sslEnabled" : true,
26   "systemInfo" : {
27     "memSizeMB" : 65536,
28     "numCores" : 16
29   },
30   "typeName": "REPLICA_SECONDARY",
31   "uptimeMsec": 489182394,
32   "username" : "mongodb",
33   "version" : "4.0.0"
34 }

注意

Cloud Manager はレスポンスで MongoDB Ops Manager を返しますが、 Monin はサポートされていません。

戻る

1 つのホストの監視を開始

1 つのホストの監視を停止

1	{
2	"alertsEnabled" : true,
3	"authMechanismName" : "SCRAM-SHA-1",
4	"clusterId" : "{CLUSTER-ID}",
5	"created" : "2014-04-22T19:56:50Z",
6	"groupId" : "{PROJECT-ID}",
7	"hasStartupWarnings" : false,
8	"hidden" : false,
9	"hostEnabled" : true,
10	"hostname" : "server1.example.com",
11	"id" : "{HOST-ID}",
12	"ipAddress": "10.1.0.10",
13	"journalingEnabled" : false,
14	"lastDataSizeBytes" : 470208719,
15	"lastIndexSizeBytes" : 110420592,
16	"lastPing" : "2016-08-15T17:57:12Z",
17	"links" : [ ],
18	"logsEnabled" : false,
19	"lowUlimit" : false,
20	"muninEnabled" : false,
21	"port" : 26000,
22	"profilerEnabled" : false,
23	"replicaSetName": "rs1",
24	"replicaStateName" : "SECONDARY",
25	"sslEnabled" : true,
26	"systemInfo" : {
27	"memSizeMB" : 65536,
28	"numCores" : 16
29	},
30	"typeName": "REPLICA_SECONDARY",
31	"uptimeMsec": 489182394,
32	"username" : "mongodb",
33	"version" : "4.0.0"
34	}

注意