API предварительной проверки удаления узла

POST /_internal/prevalidate_node_removal

Этот API проверяет, приведет ли попытка удалить указанный узел(ы) из кластера к успеху или нет. Для кластера без неназначенных фрагментов удаление любого узла считается безопасным, что означает, что удаление узлов, вероятно, пройдет успешно.

В случае, если у кластера есть red состояние здоровья кластера, он проверяет, что удаление узла(ов) не приведет к риску удаления последней копии неназначенного фрагмента. Если в кластере есть красные индексы, API проверяет, являются ли красные индексы индексами поисковых снимков, и если нет, то отправляет запрос на каждый из узлов, указанных в вызове API, чтобы проверить, могут ли узлы содержать локальные копии фрагментов красных индексов, которые не являются индексами поисковых снимков. Этот запрос обрабатывается на каждом принимающем узле путем проверки наличия каталога фрагментов для любого из фрагментов красного индекса.

Ответ включает общую безопасность удаления указанных узлов и подробный ответ для каждого узла. Специфическая для узла часть ответа также содержит более подробную информацию о том, почему удаление этого узла может не удаться.

Обратите внимание, что должен использоваться только один из параметров запроса (names, ids или external_ids) для указания набора узлов.

Обратите внимание, что если результат предварительной проверки для набора узлов возвращает true (т.е. вероятно, пройдёт успешно), это не означает, что все эти узлы могут быть удалены сразу, а скорее, удаление каждого отдельного узла может потенциально быть успешным. Фактическое удаление узлов может выполняться с помощью API жизненного цикла узлов.

В этом примере проверяется, безопасно ли удалить узлы node1 и node2. Ответ указывает, что безопасно удалить node1, но возможно, не безопасно удалить node2, так как он может содержать копии указанных фрагментов красных индексов. Поэтому общая предварительная проверка удаления двух узлов возвращает false.

resp = client.perform_request(
    "POST",
    "/_internal/prevalidate_node_removal",
    params={
        "names": "node1,node2"
    },
)
print(resp)

const response = await client.transport.request({
  method: "POST",
  path: "/_internal/prevalidate_node_removal",
  querystring: {
    names: "node1,node2",
  },
});
console.log(response);

POST /_internal/prevalidate_node_removal?names=node1,node2

API возвращает следующий ответ:

{
  "is_safe": false,
  "message": "removal of the following nodes might not be safe: [node2-id]",
  "nodes": [
    {
      "id": "node1-id",
      "name" : "node1",
      "external_id" : "node1-externalId",
      "result" : {
        "is_safe": true,
        "reason": "no_red_shards_on_node",
        "message": ""
      }
    },
    {
      "id": "node2-id",
      "name" : "node2",
      "external_id" : "node2-externalId",
      "result" : {
        "is_safe": false,
        "reason": "red_shards_on_node",
        "message": "node contains copies of the following red shards: [[indexName][0]]"
      }
    }
  ]
}