› › ›

API монтирования снимка

Монтирует снимок в виде индекса с возможностью поиска.

Запрос

POST /_snapshot/<repository>/<snapshot>/_mount

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

Если в Elasticsearch включены функции безопасности, у вас должна быть привилегия manage кластера и привилегия manage для любого включённого индекса, чтобы использовать этот API. Дополнительная информация находится в разделе Безопасность и привилегии.

Описание

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

<repository>: (Обязательно, строка) Название репозитория, содержащего снимок индекса, который нужно смонтировать.
<snapshot>: (Обязательно, строка) Название снимка индекса, который нужно смонтировать.

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

master_timeout

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

wait_for_completion

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

storage

(Необязательно, строка) Параметр монтирования индекса с возможностью поиска. Возможные значения:

full_copy (По умолчанию): Полностью смонтированный индекс.
shared_cache: Частично смонтированный индекс.

Тело запроса

index: (Обязательно, строка) Имя индекса, содержащегося в снимке, данные которого нужно смонтировать.

Если не указано renamed_index, это имя также будет использовано для создания нового индекса.

renamed_index: (Необязательно, строка) Имя индекса, который будет создан.
index_settings: (Необязательно, объект) Параметры, которые должны быть добавлены в индекс при монтировании.
ignore_index_settings: (Необязательно, массив строк) Имена параметров, которые должны быть удалены из индекса при монтировании.

Примеры

Монтирует индекс my_docs из существующего снимка с именем my_snapshot, хранящегося в репозитории my_repository, как новый индекс docs:

POST /_snapshot/my_repository/my_snapshot/_mount?wait_for_completion=true
{
  "index": "my_docs", 
  "renamed_index": "docs", 
  "index_settings": { 
    "index.number_of_replicas": 0
  },
  "ignore_index_settings": [ "index.refresh_interval" ] 
}

	Имя индекса в снимке, который нужно смонтировать
	Имя создаваемого индекса
	Параметры индекса, которые нужно добавить к новому индексу
	Список параметров индекса, которые нужно проигнорировать при монтировании снимка индекса

© 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/searchable-snapshots-api-mount-snapshot.html