Switches the indices, ILM policies, and legacy, composable and component templates from using custom node attributes and Added in 7.14.0
attribute-based allocation filters to using data tiers, and optionally deletes one legacy index template.+ Using node roles enables ILM to automatically move the indices between data tiers.
Query parameters
-
dry_run boolean
If true, simulates the migration from node attributes based allocation filters to data tiers, but does not perform the migration. This provides a way to retrieve the indices and ILM policies that need to be migrated.
Body
-
legacy_template_to_delete string
-
node_attribute string
POST /_ilm/migrate_to_data_tiers
curl \
-X POST http://api.example.com/_ilm/migrate_to_data_tiers \
-H "Content-Type: application/json" \
-d '"{\n \"legacy_template_to_delete\": \"global-template\",\n \"node_attribute\": \"custom_attribute_name\"\n}"'
Request example
The example migrates the indices, ILM policies, legacy templates, composable, and component templates away from defining custom allocation filtering using the custom_attribute_name node attribute, and deletes the legacy template with name global-template if it exists in the system.
{
"legacy_template_to_delete": "global-template",
"node_attribute": "custom_attribute_name"
}
Response examples (200)
{
"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"]
}