[docs] wait_for_completion

I speculatively linked to {ref}/tasks.html[Tasks APIs], hoping that it'll
exist before we merge this to master.
This commit is contained in:
Nik Everett 2016-01-28 15:15:32 -05:00
parent d483901434
commit 72b2ea781b
1 changed files with 8 additions and 1 deletions

View File

@ -460,12 +460,19 @@ POST /_reindex
=== URL Parameters
In addition to the standard parameters like `pretty`, all APIs in this plugin
support `refresh`, `consistency`, and `timeout`.
support `refresh`, `wait_for_completion`, `consistency`, and `timeout`.
Sending the `refresh` url parameter will cause all indexes to which the request
wrote to be refreshed. This is different than the Index API's `refresh`
parameter which causes just the shard that received the new data to be indexed.
If the request contains `wait_for_completion=false` then Elaasticsearch will
perform some preflight checks, launch the request, and then return a `task`
which can be used with {ref}/tasks.html[Tasks APIs] to cancel or get the status
of the task. For now, once the request is finished the task is gone and the
only place to look for the ultimate result of the task is in the Elasticsearch
log file. This be fixed soon.
`consistency` controls how many copies of a shard must respond to each write
request. `timeout` controls how long each write request waits for unavailable
shards to become available. Both work exactly how they work in the