› › ›

API миграции на маршрутизацию по уровням данных

Переключает индексы, политики ILM и устаревшие, составные и компонентные шаблоны с использования пользовательских атрибутов узлов и фильтров распределения на основе атрибутов на использование уровней данных, а также (по желанию) удаляет один устаревший шаблон индекса. Использование ролей узлов позволяет ILM автоматически перемещать индексы между уровнями данных.

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

Данный API предоставляет автоматический способ выполнения четырёх из пяти ручных шагов, указанных в руководстве по миграции:

Запрос

POST /_ilm/migrate_to_data_tiers

API принимает необязательный заголовок, позволяющий указать:

Название устаревшего шаблона индекса для удаления. По умолчанию не используется.
Название пользовательского атрибута узла, используемого для фильтрации распределения индексов и политик ILM. По умолчанию data.

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

ILM должен быть остановлен перед выполнением миграции. Используйте API остановки ILM для остановки ILM и API получения статуса для ожидания, пока указанный режим работы не станет STOPPED.

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

dry_run: (Необязательный, булево) Если true, симулирует миграцию с фильтров распределения на основе атрибутов узлов на уровни данных, но не выполняет миграцию. Это позволяет получить список индексов и политик ILM, которые необходимо мигрировать. По умолчанию false.

При симуляции миграции (т.е. dry_run равно true) ILM останавливать не нужно.

Примеры

Следующий пример мигрирует индексы, политики ILM, устаревшие, составные и компонентные шаблоны, убрав пользовательскую настройку фильтрации распределения, используя атрибут узла custom_attribute_name и удаляет устаревший шаблон индекса с именем global-template, если он существует в системе.

POST /_ilm/migrate_to_data_tiers
{
  "legacy_template_to_delete": "global-template",
  "node_attribute": "custom_attribute_name"
}

В случае успешного запроса будет получен ответ, подобный следующему:

{
  "dry_run": false,
  "removed_legacy_template":"global-template", 
  "migrated_ilm_policies":["policy_with_allocate_action"], 
  "migrated_indices":["warm-index-to-migrate-000001"], 
  "migrated_legacy_templates":["a-legacy-template"], 
  "migrated_composable_templates":["a-composable-template"], 
  "migrated_component_templates":["a-component-template"] 
}

	Отображает имя удалённого устаревшего шаблона индекса. Будет отсутствовать, если устаревший шаблон не был удалён.
	Обновлённые политики ILM.
	Индексы, переведённые на маршрутизацию по предпочтению уровня.
	Устаревшие шаблоны индексов, из которых были удалены пользовательские настройки маршрутизации для предоставленного атрибута данных.
	Составные шаблоны индексов, из которых были удалены пользовательские настройки маршрутизации для предоставленного атрибута данных.
	Шаблоны компонентов, из которых были удалены пользовательские настройки маршрутизации для предоставленного атрибута данных.

© 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/ilm-migrate-to-data-tiers.html