66 lines
1.2 KiB
Markdown
66 lines
1.2 KiB
Markdown
---
|
|
layout: "http"
|
|
page_title: "HTTP API: /v1/agent/members"
|
|
sidebar_current: "docs-http-agent-members"
|
|
description: |-
|
|
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
|
|
|
|
<dl>
|
|
<dt>Description</dt>
|
|
<dd>
|
|
Lists the known members of the gossip pool.
|
|
</dd>
|
|
|
|
<dt>Method</dt>
|
|
<dd>GET</dd>
|
|
|
|
<dt>URL</dt>
|
|
<dd>`/v1/agent/members`</dd>
|
|
|
|
<dt>Parameters</dt>
|
|
<dd>
|
|
None
|
|
</dd>
|
|
|
|
<dt>Returns</dt>
|
|
<dd>
|
|
|
|
```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
|
|
},
|
|
...
|
|
]
|
|
```
|
|
|
|
</dd>
|
|
</dl>
|
|
|