Cluster API

The /cluster/members API endpoint

/cluster/members (GET)

The /cluster/members API endpoint provides HTTP GET access to Sensu cluster data.

EXAMPLE

The following example demonstrates a request to the /cluster/members API, resulting in a JSON Map containing a Sensu cluster definition.

curl -H "Authorization: Bearer TOKEN" \
http://127.0.0.1:8080/api/core/v2/cluster/members

HTTP/1.1 200 OK
{
  "header": {
    "cluster_id": 4255616304056076734,
    "member_id": 9882886658148554927,
    "raft_term": 2
  },
  "members": [
    {
      "ID": 9882886658148554927,
      "name": "default",
      "peerURLs": [
        "http://127.0.0.1:2380"
      ],
      "clientURLs": [
        "http://127.0.0.1:2379"
      ]
    }
  ]
}

API Specification

/cluster/members (GET)
description Returns the cluster definition.
example url http://hostname:8080/api/core/v2/cluster/members
response type Map
response codes
  • Success: 200 (OK)
  • Error: 500 (Internal Server Error)
example output
{
  "header": {
    "cluster_id": 4255616304056076734,
    "member_id": 9882886658148554927,
    "raft_term": 2
  },
  "members": [
    {
      "ID": 9882886658148554927,
      "name": "default",
      "peerURLs": [
        "http://127.0.0.1:2380"
      ],
      "clientURLs": [
        "http://127.0.0.1:2379"
      ]
    }
  ]
}

The /cluster/members/:member API endpoint

/cluster/members/:member (DELETE)

The /cluster/members/:member API endpoint provides HTTP DELETE access to remove a Sensu cluster member.

API Specification

/cluster/ members/:member (DELETE)
description Removes a member from a Sensu cluster given the member ID.
example url http://hostname:8080/api/core/v2/cluster/members/9882886658148554927
response codes
  • Success: 202 (Accepted)
  • Missing: 404 (Not Found)
  • Error: 500 (Internal Server Error)