WARNING: The 2.x versions of Elasticsearch have passed their EOL dates. If you are running a 2.x version, we strongly advise you to upgrade.
This documentation is no longer maintained and may be removed. For the latest information, see the current Elasticsearch documentation.
Changing Settings Dynamicallyedit
Many settings in Elasticsearch are dynamic and can be modified through the API. Configuration changes that force a node (or cluster) restart are strenuously avoided. And while it’s possible to make the changes through the static configs, we recommend that you use the API instead.
The cluster-update API operates in two modes:
- Transient
- These changes are in effect until the cluster restarts. Once a full cluster restart takes place, these settings are erased.
- Persistent
- These changes are permanently in place unless explicitly changed. They will survive full cluster restarts and override the static configuration files.
Transient versus persistent settings are supplied in the JSON body:
PUT /_cluster/settings
{
"persistent" : {
"discovery.zen.minimum_master_nodes" : 2
},
"transient" : {
"indices.store.throttle.max_bytes_per_sec" : "50mb"
}
}
|
This persistent setting will survive full cluster restarts. |
|
|
This transient setting will be removed after the first full cluster restart. |
A complete list of settings that can be updated dynamically can be found in the online reference docs.