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

PUT /_cluster/settings

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

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

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

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

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

resp = client.cluster.put_settings(
    persistent={
        "indices.recovery.max_bytes_per_sec": "50mb"
    },
)
print(resp)

response = client.cluster.put_settings(
  body: {
    persistent: {
      'indices.recovery.max_bytes_per_sec' => '50mb'
    }
  }
)
puts response

const response = await client.cluster.putSettings({
  persistent: {
    "indices.recovery.max_bytes_per_sec": "50mb",
  },
});
console.log(response);

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

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

resp = client.cluster.put_settings(
    flat_settings=True,
    transient={
        "indices.recovery.max_bytes_per_sec": "20mb"
    },
)
print(resp)

response = client.cluster.put_settings(
  flat_settings: true,
  body: {
    transient: {
      'indices.recovery.max_bytes_per_sec' => '20mb'
    }
  }
)
puts response

const response = await client.cluster.putSettings({
  flat_settings: "true",
  transient: {
    "indices.recovery.max_bytes_per_sec": "20mb",
  },
});
console.log(response);

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

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

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

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

resp = client.cluster.put_settings(
    transient={
        "indices.recovery.max_bytes_per_sec": None
    },
)
print(resp)

response = client.cluster.put_settings(
  body: {
    transient: {
      'indices.recovery.max_bytes_per_sec' => nil
    }
  }
)
puts response

const response = await client.cluster.putSettings({
  transient: {
    "indices.recovery.max_bytes_per_sec": null,
  },
});
console.log(response);

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

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

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

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

resp = client.cluster.put_settings(
    transient={
        "indices.recovery.*": None
    },
)
print(resp)

response = client.cluster.put_settings(
  body: {
    transient: {
      "indices.recovery.*": nil
    }
  }
)
puts response

const response = await client.cluster.putSettings({
  transient: {
    "indices.recovery.*": null,
  },
});
console.log(response);

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