open-nomad/website/source/api/status.html.md
Charlie Voiselle fb5091678b Changed nomad.rocks to localhost:4646 to align with defaults
Should provide cut and paste example for most users. Advanced users should be able to correct URLs to something appropriate.
2018-01-29 11:27:52 -05:00

1.6 KiB

layout page_title sidebar_current description
api Status - HTTP API api-status The /status endpoints query the Nomad system status.

Status HTTP API

The /status endpoints query the Nomad system status.

Read Leader

This endpoint returns the address of the current leader in the region.

Method Path Produces
GET /status/leader application/json

The table below shows this endpoint's support for blocking queries and required ACLs.

Blocking Queries ACL Required
NO none

Sample Request

$ curl \
    https://localhost:4646/v1/status/leader

Sample Response

"127.0.0.1:4647"

List Peers

This endpoint returns the set of raft peers in the region.

Method Path Produces
GET /status/peers application/json

The table below shows this endpoint's support for blocking queries and required ACLs.

Blocking Queries ACL Required
NO none

Sample Request

$ curl \
    https://localhost:4646/v1/status/peers

Sample Response

[
  "127.0.0.1:4647"
]