open-nomad/website/source/docs/http/agent-members.html.md
Sean Chittenden bff57a0dce
Reconcile, clean up, and centralize API version numbers (major and minor).
Reduce future confusion by introducing a minor version that is gossiped out
via the `mvn` Serf tag (Minor Version Number, `vsn` is already being used for
to communicate `Major Version Number`).

Background: hashicorp/consul/issues/1346#issuecomment-151663152
2016-06-10 15:50:11 -04:00

1.2 KiB

layout page_title sidebar_current description
http HTTP API: /v1/agent/members docs-http-agent-members The '/1/agent/members' endpoint is used to query the gossip peers.

/v1/agent/members

The members endpoint is used to query the agent for the known peers in the gossip pool. This is only applicable to servers.

GET

Description
Lists the known members of the gossip pool.
Method
GET
URL
`/v1/agent/members`
Parameters
None
Returns
```javascript
[
{
    "Name": "Armons-MacBook-Air.local.global",
    "Addr": "127.0.0.1",
    "Port": 4648,
    "Tags": {
        "bootstrap": "1",
        "build": "0.1.0dev",
        "dc": "dc1",
        "port": "4647",
        "region": "global",
        "role": "nomad",
        "vsn": "1"
    },
    "Status": "alive",
    "ProtocolMin": 1,
    "ProtocolMax": 3,
    "ProtocolCur": 2,
    "DelegateMin": 2,
    "DelegateMax": 4,
    "DelegateCur": 4
},
...
]
```