|  | @@ -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}
 | 
	
		
			
				|  |  |  
 | 
	
	
		
			
				|  | @@ -28,7 +27,7 @@ users can use this API.
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  [[voting-config-exclusions-api-desc]]
 | 
	
		
			
				|  |  |  ==== {api-description-title}
 | 
	
		
			
				|  |  | -  
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  |  By default, if there are more than three master-eligible nodes in the cluster
 | 
	
		
			
				|  |  |  and you remove fewer than half of the master-eligible nodes in the cluster at
 | 
	
		
			
				|  |  |  once, the <<modules-discovery-voting,voting configuration>> automatically
 | 
	
	
		
			
				|  | @@ -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>>.
 | 
	
		
			
				|  |  |  
 | 
	
	
		
			
				|  | @@ -94,7 +98,7 @@ list. Defaults to `true`, meaning that all excluded nodes must be removed from
 | 
	
		
			
				|  |  |  the cluster before this API takes any action. If set to `false` then the voting
 | 
	
		
			
				|  |  |  configuration exclusions list is cleared even if some excluded nodes are still
 | 
	
		
			
				|  |  |  in the cluster. Only applies to the `DELETE` form of this API.
 | 
	
		
			
				|  |  | -  
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  |  [[voting-config-exclusions-api-example]]
 | 
	
		
			
				|  |  |  ==== {api-examples-title}
 | 
	
		
			
				|  |  |  
 | 
	
	
		
			
				|  | @@ -102,7 +106,7 @@ Adds nodes named `nodeName1` and `nodeName2` to the voting configuration
 | 
	
		
			
				|  |  |  exclusions list:
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  [source,console]
 | 
	
		
			
				|  |  | --------------------------------------------------- 
 | 
	
		
			
				|  |  | +--------------------------------------------------
 | 
	
		
			
				|  |  |  POST /_cluster/voting_config_exclusions?node_names=nodeName1,nodeName2
 | 
	
		
			
				|  |  |  --------------------------------------------------
 | 
	
		
			
				|  |  |  
 |