API закрытия индекса

POST /<index>/_close

Вы используете API закрытия индекса для закрытия открытых индексов.

Закрытый индекс заблокирован для операций чтения/записи и не позволяет выполнять все операции, разрешенные открытым индексам. Невозможно добавлять документы или искать документы в закрытом индексе. Это позволяет закрытым индексам не поддерживать внутренние структуры данных для индексирования или поиска документов, что приводит к меньшей нагрузке на кластер.

При открытии или закрытии индекса мастер отвечает за перезапуск фрагментов индекса, чтобы отразить новое состояние индекса. Затем фрагменты пройдут обычный процесс восстановления. Данные открытых/закрытых индексов автоматически реплицируются кластером, чтобы гарантировать, что в любое время достаточно копий фрагментов хранится безопасно.

Вы можете открывать и закрывать несколько индексов. Ошибка будет выброшена, если запрос явно ссылается на отсутствующий индекс. Это поведение можно отключить, используя параметр ignore_unavailable=true.

По умолчанию необходимо явно указать имена индексов, которые вы открываете или закрываете. Чтобы открыть или закрыть индексы с использованием _all, * или других выражений с подстановкой, измените значение action.destructive_requires_name на false. Это значение также может быть изменено с помощью API обновления настроек кластера.

Закрытые индексы потребляют значительное количество дискового пространства, что может вызвать проблемы в управляемых средах. Закрытие индексов можно отключить с помощью API настроек кластера, установив значение cluster.indices.close.enable на false. По умолчанию значение равно true.

Следующий пример демонстрирует, как закрыть индекс:

resp = client.indices.close(
    index="my-index-000001",
)
print(resp)

response = client.indices.close(
  index: 'my-index-000001'
)
puts response

const response = await client.indices.close({
  index: "my-index-000001",
});
console.log(response);

POST /my-index-000001/_close

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

{
  "acknowledged": true,
  "shards_acknowledged": true,
  "indices": {
    "my-index-000001": {
      "closed": true
    }
  }
}