github-mirrors/elasticsearch
1
0
Fork 0
mirror of https://github.com/elastic/elasticsearch.git synced 2025-06-28 17:34:17 -04:00
Code Issues Projects Releases Packages Wiki Activity

Clarify status of response to voting config API (#115714)

Browse source 
These APIs return no body, just a status code. This commit clarifies
that in the docs.

Closes #115462
This commit is contained in:
David Turner 2024-10-28 06:07:27 +00:00 • committed by GitHub
parent 06cdd11193
commit 5fb1e23f45
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 13 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

16
docs/reference/cluster/voting-exclusions.asciidoc
View file

@ -7,7 +7,6 @@
Adds or removes master-eligible nodes from the
<<modules-discovery-voting,voting configuration exclusion list>>.
[[voting-config-exclusions-api-request]]
==== {api-request-title}
@ -50,14 +49,19 @@ use `DELETE /_cluster/voting_config_exclusions?wait_for_removal=false` to clear
the voting configuration exclusions without waiting for the nodes to leave the
cluster.
If the API fails, you can safely retry it. Only a successful response
guarantees that the node has been removed from the voting configuration and
will not be reinstated.
A response to `POST /_cluster/voting_config_exclusions` with an HTTP status
code of `200 OK` guarantees that the node has been removed from the voting
configuration and will not be reinstated until the voting configuration
exclusions are cleared by calling `DELETE /_cluster/voting_config_exclusions`.
If the call to `POST /_cluster/voting_config_exclusions` fails or returns a
response with an HTTP status code other than `200 OK` then the node may not
have been removed from the voting configuration. In that case, you may safely
retry the call.
NOTE: Voting exclusions are required only when you remove at least half of the
master-eligible nodes from a cluster in a short time period. They are not
required when removing master-ineligible nodes or fewer than half of the
master-eligible nodes.
required when removing master-ineligible nodes or when removing fewer than half
of the master-eligible nodes.
For more information, see <<modules-discovery-removing-nodes>>.