投票配置排除项
_cluster/voting_config_exclusions API 允许您将一个或多个节点从投票配置中排除。当您想要安全地从集群中移除符合集群管理器条件的节点或更改当前集群管理器时，这非常有用。
添加投票配置排除项
使用 POST 方法添加投票配置排除项。
端点
POST /_cluster/voting_config_exclusions
查询参数
下表列出了可用的查询参数。所有查询参数都是可选的。
| 参数 | 数据类型 | 描述 |
|---|---|---|
node_ids | 列表或字符串 | 要从投票配置中排除的节点 ID 的逗号分隔列表。使用此设置时，不能同时指定 node_names。必须指定 node_ids 或 node_names 才能收到有效响应。 |
node_names | 列表或字符串 | 要从投票配置中排除的节点名称的逗号分隔列表。使用此设置时，不能同时指定 node_ids。必须指定 node_ids 或 node_names 才能收到有效响应。 |
超时 | 字符串 | 添加投票配置排除项时，API 会等待指定节点从投票配置中排除，然后才返回响应。如果超时时间在满足相应条件之前到期，则请求失败并返回错误。 |
示例
将名为 opensearch-node1 的节点从投票配置中排除
POST /_cluster/voting_config_exclusions?node_names=opensearch-node1
或者，您可以将节点 ID 指定为逗号分隔列表
POST /_cluster/voting_config_exclusions?node_ids=6ITS4DmNR7OJT1G5lyW8Lw,PEEW2S7-Su2XCA4zUE9_2Q
移除投票配置排除项
使用 DELETE 方法清除先前从投票配置中排除的节点列表。这通常在排除的节点已安全移除或替换后使用。您可以选择等待节点从集群中移除后再清除排除项。
端点
DELETE /_cluster/voting_config_exclusions
查询参数
下表列出了可用的查询参数。所有查询参数都是可选的。
| 参数 | 数据类型 | 描述 |
|---|---|---|
wait_for_removal | 布尔型 | 指定是否在清除投票配置排除列表之前等待所有被排除的节点从集群中移除。当为 true 时，所有被排除的节点在 API 执行任何操作之前都会从集群中移除。当为 false 时，即使集群中仍存在一些被排除的节点，投票配置排除列表也会被清除。（默认值：true） |
示例
使用以下请求移除所有投票配置排除项，无需等待节点被移除
DELETE /_cluster/voting_config_exclusions?wait_for_removal=false