機能移行API

これらのAPIは、Kibanaのアップグレードアシスタントによる間接的な使用のために設計されています。7.17から8.15.2にアップグレードするには、アップグレードアシスタントの使用を強く推奨します。アップグレード手順については、Elastic 8.15.2へのアップグレードを参照してください。

バージョンのアップグレードには、機能が構成情報やデータをシステムインデックスに保存する方法の変更が必要な場合があります。機能移行APIを使用すると、変更が必要な機能を確認し、自動移行プロセスを開始し、移行状況を確認できます。

移行プロセス中は、一部の機能が一時的に利用できなくなる場合があります。

リクエスト

GET /_migration/system_features

POST /_migration/system_features

前提条件

  • Elasticsearchのセキュリティ機能が有効になっている場合、このAPIを使用するには、manage クラスター権限が必要です。

説明

_migration/system_features エンドポイントにGETリクエストを送信して、移行が必要な機能と進行中の移行のステータスを確認します。

エンドポイントにPOSTリクエストを送信して、移行プロセスを開始します。

例

_migration/system_features エンドポイントにGETリクエストを送信すると、移行が必要な機能のステータスが応答として返されます。

Python

  1. resp = client.migration.get_feature_upgrade_status()
  2. print(resp)

Ruby

  1. response = client.migration.get_feature_upgrade_status
  2. puts response

Js

  1. const response = await client.migration.getFeatureUpgradeStatus();
  2. console.log(response);

コンソール

  1. GET /_migration/system_features

例の応答:

コンソール-結果

  1. {
  2.   "features" : [
  3.    {
  4.    "feature_name" : "async_search",
  5.    "minimum_index_version" : "8100099",
  6.    "migration_status" : "NO_MIGRATION_NEEDED",
  7.    "indices" : [ ]
  8.    },
  9.    {
  10.    "feature_name" : "enrich",
  11.    "minimum_index_version" : "8100099",
  12.    "migration_status" : "NO_MIGRATION_NEEDED",
  13.    "indices" : [ ]
  14.    },
  15.    {
  16.    "feature_name" : "ent_search",
  17.    "minimum_index_version" : "8100099",
  18.    "migration_status" : "NO_MIGRATION_NEEDED",
  19.    "indices" : [ ]
  20.    },
  21.    {
  22.    "feature_name" : "fleet",
  23.    "minimum_index_version" : "8100099",
  24.    "migration_status" : "NO_MIGRATION_NEEDED",
  25.    "indices" : [ ]
  26.    },
  27.    {
  28.    "feature_name" : "geoip",
  29.    "minimum_index_version" : "8100099",
  30.    "migration_status" : "NO_MIGRATION_NEEDED",
  31.    "indices" : [ ]
  32.    },
  33.    {
  34.    "feature_name" : "kibana",
  35.    "minimum_index_version" : "8100099",
  36.    "migration_status" : "NO_MIGRATION_NEEDED",
  37.    "indices" : [ ]
  38.    },
  39.    {
  40.    "feature_name" : "logstash_management",
  41.    "minimum_index_version" : "8100099",
  42.    "migration_status" : "NO_MIGRATION_NEEDED",
  43.    "indices" : [ ]
  44.    },
  45.    {
  46.    "feature_name" : "machine_learning",
  47.    "minimum_index_version" : "8100099",
  48.    "migration_status" : "NO_MIGRATION_NEEDED",
  49.    "indices" : [ ]
  50.    },
  51.    {
  52.    "feature_name" : "searchable_snapshots",
  53.    "minimum_index_version" : "8100099",
  54.    "migration_status" : "NO_MIGRATION_NEEDED",
  55.    "indices" : [ ]
  56.    },
  57.    {
  58.    "feature_name" : "security",
  59.    "minimum_index_version" : "8100099",
  60.    "migration_status" : "NO_MIGRATION_NEEDED",
  61.    "indices" : [ ]
  62.    },
  63.    {
  64.    "feature_name" : "synonyms",
  65.    "minimum_index_version" : "8100099",
  66.    "migration_status" : "NO_MIGRATION_NEEDED",
  67.    "indices" : [ ]
  68.    },
  69.    {
  70.    "feature_name" : "tasks",
  71.    "minimum_index_version" : "8100099",
  72.    "migration_status" : "NO_MIGRATION_NEEDED",
  73.    "indices" : [ ]
  74.    },
  75.    {
  76.    "feature_name" : "transform",
  77.    "minimum_index_version" : "8100099",
  78.    "migration_status" : "NO_MIGRATION_NEEDED",
  79.    "indices" : [ ]
  80.    },
  81.    {
  82.    "feature_name" : "watcher",
  83.    "minimum_index_version" : "8100099",
  84.    "migration_status" : "NO_MIGRATION_NEEDED",
  85.    "indices" : [ ]
  86.    }
  87.   ],
  88.   "migration_status" : "NO_MIGRATION_NEEDED"
  89. }

_migration/system_features エンドポイントにPOSTリクエストを送信して移行プロセスを開始すると、応答には移行される機能が示されます。

Python

  1. resp = client.migration.post_feature_upgrade()
  2. print(resp)

Ruby

  1. response = client.migration.post_feature_upgrade
  2. puts response

Js

  1. const response = await client.migration.postFeatureUpgrade();
  2. console.log(response);

コンソール

  1. POST /_migration/system_features

例の応答:

コンソール-結果

  1. {
  2.   "accepted" : true,
  3.   "features" : [
  4.    {
  5.    "feature_name" : "security"
  6.    }
  7.   ]
  8. }
Elasticsearchのセキュリティがクラスターのアップグレード前に移行されます。

その後のGETリクエストは、移行プロセスのステータスを返します。