github
/
consul
mirror of https://github.com/hashicorp/consul
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Some further cleanups to the root http doc.

pull/666/head
Ryan Breen 2015-02-02 00:14:16 -05:00
parent 27c145e2f8
commit 0d8ec87456
1 changed files with 11 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
website/source/docs/agent/http.html.markdown
View File

@ -16,7 +16,7 @@ Each endpoint manages a different aspect of Consul:
* [kv](http/kv.html) - Key/Value store * [kv](http/kv.html) - Key/Value store
* [agent](http/agent.html) - Consul Agent * [agent](http/agent.html) - Consul Agent
* [catalog](http/catalog.html) - Modes and services * [catalog](http/catalog.html) - Nodes and services
* [health](http/health.html) - Health checks * [health](http/health.html) - Health checks
* [session](http/session.html) - Sessions * [session](http/session.html) - Sessions
* [acl](http/acl.html) - Access Control Lists * [acl](http/acl.html) - Access Control Lists
@ -32,14 +32,14 @@ Certain endpoints support a feature called a "blocking query." A blocking query
is used to wait for a potential change using long polling. is used to wait for a potential change using long polling.
Not all endpoints support blocking, but those that do are clearly designated in the Not all endpoints support blocking, but those that do are clearly designated in the
documentations. Any endpoint that supports blocking will also set the HTTP header documentation. Any endpoint that supports blocking will also set the HTTP header
`X-Consul-Index`, a unique identifier representing the current state of this `X-Consul-Index`, a unique identifier representing the current state of the
requested resource. When again requesting this resource, the client can set the `index` requested resource. On subsequent requests for this resource, the client can set the `index`
query string parameter to the value of "X-Consul-Index", indicating that it wishes to wait query string parameter to the value of `X-Consul-Index`, indicating that the client wishes
for any changes subsequent to that index. to wait for any changes subsequent to that index.
In addition to `index`, endpoints that support blocking will also honor a `wait` In addition to `index`, endpoints that support blocking will also honor a `wait`
parameter specifying a maximum duration for the blocking request. It not set, it will parameter specifying a maximum duration for the blocking request. If not set, it will
default to 10 minutes. This value can be specified in the form of "10s" or "5m" (i.e., default to 10 minutes. This value can be specified in the form of "10s" or "5m" (i.e.,
10 seconds or 5 minutes, respectively). 10 seconds or 5 minutes, respectively).
@ -67,11 +67,11 @@ The three read modes are:
increased latency due to an extra round trip. Most clients should not use this increased latency due to an extra round trip. Most clients should not use this
unless they cannot tolerate a stale read. unless they cannot tolerate a stale read.
* stale - This mode allows any server to service the read regardless of if * stale - This mode allows any server to service the read regardless of whether
it is the leader. This means reads can be arbitrarily stale but are generally it is the leader. This means reads can be arbitrarily stale; however, results are generally
consistent to within 50 milliseconds of the leader. The trade-off is very fast and consistent to within 50 milliseconds of the leader. The trade-off is very fast and
scalable reads with a higher likelihood of stale values. This mode allows reads without scalable reads with a higher likelihood of stale values. Since this mode allows reads without
a leader, meaning a cluster that is unavailable will still be able to respond to queries. a leader, a cluster that is unavailable will still be able to respond to queries.
To switch these modes, either the `stale` or `consistent` query parameters To switch these modes, either the `stale` or `consistent` query parameters
should be provided on requests. It is an error to provide both. should be provided on requests. It is an error to provide both.