List NMS configuration servers

GET

/nmsconfig/servers

Last modified:2026-09-29 19:08:00

OperationId:ListNmsConfigServers

Lists every core server with whether it answered, how many configuration entries it holds, and how many of those disagree with the other servers.

Requires Super User or Super User Read Only.

The list comes from the cluster inventory (element_domain), not from the servers that answered, so a server that is down appears with config-server-reachable: no and null counts instead of vanishing or reading as empty. A server has 3 seconds to answer.

The counts cover the server's whole table, not a page. config-server-out-of-sync-count counts the server's keys whose config-in-sync is no, including keys other servers lack; keys that are not-expected or unknown are left out, so a non-zero count is always worth a look. The serving server reports config-server-reachable: no when it cannot read its own table. An inventory entry that is not a valid hostname is listed as unreachable and never contacted. GET /appinfo lists the raw inventory instead.

Only GET is answered.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Responses

🟢200OK

application/json

One row per core server in the inventory.

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠405Method Not Allowed

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/nmsconfig/servers' \
--header 'Authorization: Bearer <token>'

Response Example

200 - One server down

[
    {
        "config-server": "core1.example.com",
        "config-server-local": "yes",
        "config-server-reachable": "yes",
        "config-server-config-count": 412,
        "config-server-out-of-sync-count": 1
    },
    {
        "config-server": "core2.example.com",
        "config-server-local": "no",
        "config-server-reachable": "yes",
        "config-server-config-count": 412,
        "config-server-out-of-sync-count": 1
    },
    {
        "config-server": "core3.example.com",
        "config-server-local": "no",
        "config-server-reachable": "no",
        "config-server-config-count": null,
        "config-server-out-of-sync-count": null
    }
]

Modified at 2026-09-29 19:08:00

List NMS configuration key names

Read NMS configuration entry