API обновления настроек кластера

PUT /_cluster/settings

Вы можете настроить и обновить динамические настройки в работающем кластере с помощью API обновления настроек кластера. Вы также можете настроить динамические настройки локально на неинициализированном или остановленном узле, используя elasticsearch.yml.

Обновления, выполненные с помощью API обновления настроек кластера, могут быть постоянными, которые применяются при перезапуске кластера, или временными, которые сбрасываются после перезапуска кластера. Вы также можете сбросить временные или постоянные настройки, присвоив им значение null с помощью API.

Если вы настраиваете одну и ту же настройку несколькими способами, Elasticsearch применяет настройки в следующем порядке приоритета:

Например, вы можете применить временную настройку, чтобы переопределить постоянную настройку или elasticsearch.yml настройку. Однако изменение elasticsearch.yml настройки не переопределит определённую временную или постоянную настройку.

Пример постоянного обновления:

PUT /_cluster/settings
{
  "persistent" : {
    "indices.recovery.max_bytes_per_sec" : "50mb"
  }
}

Пример временного обновления:

PUT /_cluster/settings?flat_settings=true
{
  "transient" : {
    "indices.recovery.max_bytes_per_sec" : "20mb"
  }
}

Ответ на обновление содержит изменённую настройку, как в этом ответе на пример временного обновления:

{
  ...
  "persistent" : { },
  "transient" : {
    "indices.recovery.max_bytes_per_sec" : "20mb"
  }
}

Этот пример сбрасывает настройку:

PUT /_cluster/settings
{
  "transient" : {
    "indices.recovery.max_bytes_per_sec" : null
  }
}

Ответ не включает настройки, которые были сброшены:

{
  ...
  "persistent" : {},
  "transient" : {}
}

Вы также можете сбросить настройки, используя подстановочные знаки. Например, чтобы сбросить все динамические indices.recovery настройки:

PUT /_cluster/settings
{
  "transient" : {
    "indices.recovery.*" : null
  }
}