elasticsearch/docs/reference/rest-api
David Turner fc287bde8b
Interpret ?timeout=-1 as infinite ack timeout (#107675)
APIs which perform cluster state updates typically accept the
`?master_timeout=` and `?timeout=` parameters to respectively set the
pending task queue timeout and the acking timeout for the cluster state
update. Both of these parameters accept the value `-1`, but
`?master_timeout=-1` means to wait indefinitely whereas `?timeout=-1`
means the same thing as `?timeout=0`, namely that acking times out
immediately on commit.

There are some situations where it makes sense to wait for as long as
possible for nodes to ack a cluster state update. In practice this wait
is bounded by other mechanisms (e.g. the lag detector will remove the
node from the cluster after a couple of minutes of failing to apply
cluster state updates) but these are not really the concern of clients.

Therefore with this commit we change the meaning of `?timeout=-1` to
mean that the acking timeout is infinite.
2024-04-30 09:54:15 -04:00
..
logstash [DOCS] Move x-pack docs to docs/reference dir (#99209) 2023-09-12 14:53:41 -04:00
security [DOCS] Refactor book-scoped variables in docs/reference/index.asciidoc (#107413) 2024-04-17 14:37:07 +02:00
watcher [DOCS] Refactor book-scoped variables in docs/reference/index.asciidoc (#107413) 2024-04-17 14:37:07 +02:00
common-options.asciidoc Typo in example of the filter_path option (#84551) (#84661) 2022-03-04 09:10:55 -05:00
common-parms.asciidoc Interpret ?timeout=-1 as infinite ack timeout (#107675) 2024-04-30 09:54:15 -04:00
cron-expressions.asciidoc [DOCS] Add info about GET/POST to the API conventions. (#74529) 2021-06-30 09:24:42 -07:00
defs.asciidoc [DOCS] Refactor book-scoped variables in docs/reference/index.asciidoc (#107413) 2024-04-17 14:37:07 +02:00
index.asciidoc [DOCS] Refactor book-scoped variables in docs/reference/index.asciidoc (#107413) 2024-04-17 14:37:07 +02:00
info.asciidoc Enable Universal Profiling as Enterprise feature (#100333) 2023-10-09 07:58:04 +02:00
rest-api-compatibility.asciidoc [DOCS] Link to the 7.17 upgrade assistant docs (#83613) (#83615) 2022-02-07 18:29:26 -05:00
root.asciidoc (DOC+) Version API page for ES API Base URL (#105845) 2024-03-18 13:02:54 -06:00
security.asciidoc [DOCS] Fixes get settings and update settings security API docs (#105686) 2024-02-21 15:06:32 +01:00
usage.asciidoc [DOCS] Refactor book-scoped variables in docs/reference/index.asciidoc (#107413) 2024-04-17 14:37:07 +02:00
watcher.asciidoc [DOCS] Move x-pack docs to docs/reference dir (#99209) 2023-09-12 14:53:41 -04:00