2013-12-23 19:38:51 +00:00
|
|
|
# Agent HTTP API
|
|
|
|
|
|
|
|
The Consul agent is capable of running an HTTP server that
|
|
|
|
exposes various API's in a RESTful manner. These API's can
|
|
|
|
be used to both query the service catalog, as well as to
|
|
|
|
register new services.
|
|
|
|
|
|
|
|
The URLs are also versioned to allow for changes in the API.
|
|
|
|
The current URLs supported are:
|
|
|
|
|
|
|
|
* /v1/catalog/register : Registers a new service
|
|
|
|
* /v1/catalog/deregister : Deregisters a service or node
|
|
|
|
* /v1/catalog/datacenters : Lists known datacenters
|
|
|
|
* /v1/catalog/nodes : Lists nodes in a given DC
|
|
|
|
* /v1/catalog/services : Lists services in a given DC
|
|
|
|
* /v1/catalog/service/<service>/ : Lists the nodes in a given service
|
|
|
|
* /v1/catalog/node/<node>/ : Lists the services provided by a node
|
|
|
|
|
2014-01-10 23:13:37 +00:00
|
|
|
* Health system:
|
2013-12-23 19:38:51 +00:00
|
|
|
* /v1/health/node/<node>: Returns the health info of a node
|
2014-01-10 23:13:37 +00:00
|
|
|
* /v1/health/checks/<service>: Returns the checks of a service
|
|
|
|
* /v1/health/service/<service>: Returns the nodes and health info of a service
|
|
|
|
* /v1/health/state/<state>: Returns the checks in a given state
|
2013-12-23 19:38:51 +00:00
|
|
|
|
|
|
|
* /v1/status/leader : Returns the current Raft leader
|
|
|
|
* /v1/status/peers : Returns the current Raft peer set
|
|
|
|
|
|
|
|
* /v1/agent/health: Returns the health info from the local agent (future)
|
2014-01-04 01:15:51 +00:00
|
|
|
* /v1/agent/services : Returns the services local agent is attempting to register
|
2013-12-23 19:38:51 +00:00
|
|
|
* /v1/agent/members : Returns the members as seen by the local serf agent
|
2014-01-04 01:15:51 +00:00
|
|
|
* /v1/agent/join/<node> : Instructs the local agent to join a node
|
|
|
|
* /v1/agent/force-leave/<node>: Instructs the agent to force a node into the left state
|
2013-12-23 19:38:51 +00:00
|
|
|
|
2014-01-10 23:13:37 +00:00
|
|
|
## Future (interacts with local state?)
|
|
|
|
* /v1/health/register : Registers a new health check
|
|
|
|
* /v1/health/deregister : Deregisters a health check
|
|
|
|
* /v1/health/pass: Pass a health check
|
|
|
|
* /v1/health/warn: Warn on a health check
|
|
|
|
* /v1/health/fail: Fail a health check
|
|
|
|
|