› › ›

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, если они существуют в системе.

resp = client.ilm.migrate_to_data_tiers(
    legacy_template_to_delete="global-template",
    node_attribute="custom_attribute_name",
)
print(resp)

response = client.ilm.migrate_to_data_tiers(
  body: {
    legacy_template_to_delete: 'global-template',
    node_attribute: 'custom_attribute_name'
  }
)
puts response

const response = await client.ilm.migrateToDataTiers({
  legacy_template_to_delete: "global-template",
  node_attribute: "custom_attribute_name",
});
console.log(response);

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