› › ›

API удаления индекса

Удаляет один или несколько индексов.

DELETE /my-index-000001

Запрос

DELETE /<index>

Предварительные условия

Если включены функции безопасности Elasticsearch, у вас должна быть delete_index или manage привилегия доступа к индексу для целевого индекса.

Описание

Удаление индекса удаляет его документы, фрагменты и метаданные. Оно не удаляет связанные компоненты Kibana, такие как шаблоны индексов, визуализации или панели управления.

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

Параметры пути

<index>

(Обязательно, строка) Список индексов, которые нужно удалить, разделенный запятыми. Вы не можете указать алиасы индексов.

Чтобы удалить все индексы, используйте _all или *. Чтобы запретить удаление индексов с _all или символами подстановки, установите системное значение кластера action.destructive_requires_name на true.

Параметры запроса

allow_no_indices

(Необязательно, логическое значение) Если false, запрос возвращает ошибку, если какой-либо символ подстановки, алиас индекса или значение _all направлены только на отсутствующие или закрытые индексы. Это поведение применяется даже если запрос направлен на другие открытые индексы. Например, запрос, направленный на foo*,bar*, возвращает ошибку, если индекс начинается с foo, но ни один индекс не начинается с bar.

По умолчанию true.

expand_wildcards

(Необязательно, строка) Тип индекса, с которым могут совпадать шаблоны с символами подстановки. Если запрос может нацеливаться на потоки данных, этот аргумент определяет, будут ли шаблоны с символами подстановки соответствовать скрытым потокам данных. Поддерживаются значения, разделенные запятыми, например, open,hidden. Допустимые значения:

all: Соответствие любому потоку данных или индексу, включая скрытые.
open: Соответствие открытым, нескрытым индексам. Также соответствует любым нескрытым потокам данных.
closed: Соответствие закрытым, нескрытым индексам. Также соответствует любым нескрытым потокам данных. Потоки данных не могут быть закрыты.
hidden: Соответствие скрытым потокам данных и скрытым индексам. Должно быть комбинировано с open, closed или с обоими.
none: Шаблоны с символами подстановки не принимаются.

По умолчанию open,closed.

ignore_unavailable

(Необязательно, логическое значение) Если false, запрос возвращает ошибку, если он направлен на отсутствующий или закрытый индекс. По умолчанию false.

master_timeout

(Необязательно, единицы времени) Период ожидания подключения к мастер-узлу. Если ответ не получен до истечения времени ожидания, запрос завершается ошибкой. По умолчанию 30s.

timeout

(Необязательно, единицы времени) Период ожидания ответа. Если ответ не получен до истечения времени ожидания, запрос завершается ошибкой. По умолчанию 30s.

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/7.17/indices-delete-index.html