インデックス、ILMポリシー、レガシー、コンポーザブルおよびコンポーネントテンプレートをデータティアルーティングに移行（Migrate indices, ILM policies, and legacy, composable and component templates to data tiers routing）

データティアルーティングAPIへの移行

インデックス、ILMポリシー、レガシー、コンポーザブルおよびコンポーネントテンプレートをカスタムノード属性および 属性ベースの割り当てフィルター から データティア に切り替え、オプションで1つのレガシーインデックステンプレートを削除します。ノードロールを使用することで、ILMは インデックスを自動的に移動 できます。

カスタムノード属性ルーティングからの移行は、ノードロールへのインデックス割り当てフィルターの移行 ページに示されているように手動で実行できます。

このAPIは、移行ガイド に記載されている4つの手動ステップのうち3つを自動的に実行する方法を提供します：

• 1. 新しいインデックスにカスタムホット属性を設定しない
• 2. 既存のILMポリシーからカスタム割り当て設定を削除する
• 3. 既存のインデックスからカスタム割り当て設定を置き換える ために対応する ティアプレファレンス を使用します。

リクエスト

POST /_ilm/migrate_to_data_tiers

APIは、次のことを指定できるオプションのボディを受け入れます：

• 削除するレガシーインデックステンプレートの名前。デフォルトはなし。
• インデックスおよびILMポリシーの割り当てフィルタリングに使用されるカスタムノード属性の名前。デフォルトは data。

前提条件

• 移行を実行する前にILMを停止する必要があります。ILM停止API を使用してILMを停止し、ステータス取得API を使用して報告された操作モードが STOPPED になるまで待機します。

クエリパラメータ

• dry_run
• (オプション、ブール値) true の場合、ノード属性ベースの割り当てフィルターからデータティアへの移行をシミュレートしますが、移行は実行しません。これにより、移行が必要なインデックスおよびILMポリシーを取得する方法が提供されます。デフォルトは false。

移行をシミュレートする場合（つまり、dry_run が true の場合）、ILMを停止する必要はありません。

例

次の例は、インデックス、ILMポリシー、レガシーテンプレート、コンポーザブルおよびコンポーネントテンプレートを custom_attribute_name ノード属性を使用したカスタム割り当てフィルタリングの定義から移行し、システムに存在する場合は名前 global-template のレガシーテンプレートを削除します。

Python

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

Ruby

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

Js

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"]
}