github-mirrors/elasticsearch
1
0
Fork 0
mirror of https://github.com/elastic/elasticsearch.git synced 2025-06-29 01:44:36 -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 Adds or removes master-eligible nodes from the
<<modules-discovery-voting,voting configuration exclusion list>>. <<modules-discovery-voting,voting configuration exclusion list>>.
[[voting-config-exclusions-api-request]] [[voting-config-exclusions-api-request]]
==== {api-request-title} ==== {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 the voting configuration exclusions without waiting for the nodes to leave the
cluster. cluster.
If the API fails, you can safely retry it. Only a successful response A response to `POST /_cluster/voting_config_exclusions` with an HTTP status
guarantees that the node has been removed from the voting configuration and code of `200 OK` guarantees that the node has been removed from the voting
will not be reinstated. 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 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 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 required when removing master-ineligible nodes or when removing fewer than half
master-eligible nodes. of the master-eligible nodes.
For more information, see <<modules-discovery-removing-nodes>>. For more information, see <<modules-discovery-removing-nodes>>.