- API >
- Public API Resources >
- Deployments >
- Hosts >
- Update Configuration of One Monitored Host
Update Configuration of One Monitored Host¶
On this page
Update the configuration of a monitored MongoDB process.
Base URL: {opsManagerHost}:{port}
¶
Resource¶
Request Path Parameters¶
Parameter | Required/Optional | Description |
---|---|---|
GROUP-ID |
Required | ID of the group that owns this MongoDB process. |
HOST-ID |
Required | ID of the host for the MongoDB process. |
Request Query Parameters¶
This endpoint may use any of the HTTP request query parameters available to all Ops Manager API resources. These are all optional.
Name | Type | Description | Default |
---|---|---|---|
pageNum |
integer | Page number (1-based). | 1 |
itemsPerPage |
integer | Maximum number of items to return, up to a maximum of 100. | 100 |
pretty |
boolean | Display response in human-readable format. | false |
Request Body Parameters¶
Name | Type | Description |
---|---|---|
alertsEnabled |
boolean | Set to true if alerts should be enabled for this MongoDB
process. |
authMechanismName |
string | Specify which authentication mechanism should be used to connect to this MongoDB process. Possible values are:
|
logsEnabled |
boolean | Set to true if Ops Manager should collect logs for this MongoDB
process. |
muninPort |
number | Set the port number Munin uses to collect hardware statistics for this MongoDB process. Note Use of Munin for hardware monitoring is deprecated. For more information on Munin and Ops Manager, see Configure Hardware Monitoring with munin-node. |
password |
string | Password for connecting to this MongoDB process. If the process’s
authMechanismName is SCRAM-SHA-1 , then you must include
this field when creating the process or updating its credentials.
However, it will never be exposed when a host entity is returned. |
profilerEnabled |
boolean | Set to true if Ops Manager collects profile information from this
MongoDB process. |
sslEnabled |
boolean | Set to true if SSL/TLS should be enabled for this MongoDB
process. (Conditional: Set to true if the
authMechanismName is MONGODB_X509 .) |
username |
string | (Conditional: Specify if authMechanismName is
MONGODB_CR or SCRAM_SHA_1 .) Specify username for
connecting to this MongoDB process. |
If authMechanismName
is NONE
then any existing values for
username
and password
are cleared. If
authMechanismName
is SCRAM-SHA-1
, then you must provide both
the username
and password
.
Response Elements¶
Name | Type | Description |
---|---|---|
aliases |
array of strings | A list of alternate hostname:port combinations that Ops Manager discovered for the MongoDB process. |
alertsEnabled |
boolean | true if this MongoDB process has alerts enabled. |
authMechanismName |
string | The authentication mechanism used to connect to this MongoDB process. This displays only one of the following values:
|
clusterId |
string | The ID of the cluster to which the MongoDB process belongs. |
created |
date | Date Ops Manager created or first discovered this MongoDB process. |
deactivated |
boolean | false if the host is running; true if the host is
deactivated. |
displayName |
string | The MongoDB process’s display name in Ops Manager. If the MongoDB process does not have a display name set, Ops Manager displays the hostname. |
groupId |
string | ID of the group that owns this alert configuration. |
hasStartupWarnings |
boolean | true if this MongoDB process had startup warnings. |
hidden |
boolean | true if host is displayed in the Ops Manager UI. Hosts set to
true are omitted from API responses. |
hostEnabled |
boolean | true if the MongoDB process currently enabled. |
hostname |
string | The primary hostname as Ops Manager can best determine. |
id |
string | Unique identifier. |
ipAddress |
string | IP address associated with the hostname of this MongoDB
process. Additional accessible IP addresses may be displayed
in the aliases array. |
journalingEnabled |
boolean | true if journaling is enabled for this MongoDB process. |
lastDataSizeBytes |
number | The uncompressed size of the host’s databases on disk in bytes
excluding indexes. lastDataSizeBytes does not include
the data in the local
database. |
lastIndexSizeBytes |
number | The uncompressed size of the host’s database indexes on disk in bytes. This number does not include the size of the index for the local database. |
lastPing |
date | The point in time when the last ping for this MongoDB process was received in ISO 8601 date and time format in UTC. |
lastRestart |
date | The point in time when this process last restarted in
ISO 8601
date and time format in UTC. If the MongoDB process has never been restarted, the
lastRestart field is omitted. |
links |
array | This array includes one or more links to sub-resources and/or
related resources. The relations between URLs are explained in
the Web Linking Specification. At minimum, a
links array contains one link called self . |
logsEnabled |
boolean | true if Ops Manager is collecting logs for this MongoDB
process. |
lowUlimit |
boolean | true if this MongoDB process’s host has a low ulimit
setting. |
muninEnabled |
boolean |
Note Use of Munin for hardware monitoring is deprecated. For more information on Munin and Ops Manager, see Configure Hardware Monitoring with munin-node. |
muninPort |
number | Port number Munin uses to collect hardware statistics for this MongoDB process. Note Use of Munin for hardware monitoring is deprecated. For more information on Munin and Ops Manager, see Configure Hardware Monitoring with munin-node. |
port |
number | Port on which the MongoDB process listens. |
profilerEnabled |
boolean | true if Ops Manager collects profile information from this
MongoDB process. |
replicaSetName |
string | Name of the replica set this process belongs to. Only present if this process is part of a replica set. |
replicaStateName |
string | Current state of this MongoDB process within a replica set. Only present if this process is part of a replica set. See Replica Set Member States for possible values. |
shardName |
string | Name of the shard this process belongs to. Only present if the process is part of a sharded cluster. |
sslEnabled |
boolean | true if SSL/TLS and is enabled for this MongoDB
process. |
typeName |
string | Type for this MongoDB process. Possible values are:
The type for new hosts added to Ops Manager will be |
uptimeMsec |
number | Number of milliseconds since this process last restarted. |
version |
string | Version of MongoDB running for this process. |