› › ›

功能迁移 API

编辑

功能迁移 API编辑

这些 API 旨在供 Kibana 的 升级助手 间接使用。我们强烈建议您使用 升级助手 从 7.17 升级到 8.14.2。有关升级说明，请参阅升级到 Elastic 8.14.2。

版本升级有时需要更改功能在系统索引中存储配置信息和数据的方式。功能迁移 API 使您能够查看哪些功能需要更改，启动自动迁移过程以及检查迁移状态。

在迁移过程中，某些功能可能会暂时不可用。

请求编辑

GET /_migration/system_features

POST /_migration/system_features

先决条件编辑

如果启用了 Elasticsearch 安全功能，则您必须具有 manage 集群权限才能使用此 API。

描述编辑

向 _migration/system_features 端点提交 GET 请求，以查看需要迁移的功能以及任何正在进行的迁移的状态。

向端点提交 POST 请求以启动迁移过程。

示例编辑

当您向 _migration/system_features 端点提交 GET 请求时，响应会指示任何需要迁移的功能的状态。

response = client.migration.get_feature_upgrade_status
puts response

GET /_migration/system_features

示例响应

{
  "features" : [
    {
      "feature_name" : "async_search",
      "minimum_index_version" : "8100099",
      "migration_status" : "NO_MIGRATION_NEEDED",
      "indices" : [ ]
    },
    {
      "feature_name" : "enrich",
      "minimum_index_version" : "8100099",
      "migration_status" : "NO_MIGRATION_NEEDED",
      "indices" : [ ]
    },
    {
      "feature_name" : "ent_search",
      "minimum_index_version" : "8100099",
      "migration_status" : "NO_MIGRATION_NEEDED",
      "indices" : [ ]
    },
    {
      "feature_name" : "fleet",
      "minimum_index_version" : "8100099",
      "migration_status" : "NO_MIGRATION_NEEDED",
      "indices" : [ ]
    },
    {
      "feature_name" : "geoip",
      "minimum_index_version" : "8100099",
      "migration_status" : "NO_MIGRATION_NEEDED",
      "indices" : [ ]
    },
    {
      "feature_name" : "kibana",
      "minimum_index_version" : "8100099",
      "migration_status" : "NO_MIGRATION_NEEDED",
      "indices" : [ ]
    },
    {
      "feature_name" : "logstash_management",
      "minimum_index_version" : "8100099",
      "migration_status" : "NO_MIGRATION_NEEDED",
      "indices" : [ ]
    },
    {
      "feature_name" : "machine_learning",
      "minimum_index_version" : "8100099",
      "migration_status" : "NO_MIGRATION_NEEDED",
      "indices" : [ ]
    },
    {
      "feature_name" : "searchable_snapshots",
      "minimum_index_version" : "8100099",
      "migration_status" : "NO_MIGRATION_NEEDED",
      "indices" : [ ]
    },
    {
      "feature_name" : "security",
      "minimum_index_version" : "8100099",
      "migration_status" : "NO_MIGRATION_NEEDED",
      "indices" : [ ]
    },
    {
      "feature_name" : "synonyms",
      "minimum_index_version" : "8100099",
      "migration_status" : "NO_MIGRATION_NEEDED",
      "indices" : [ ]
    },
    {
      "feature_name" : "tasks",
      "minimum_index_version" : "8100099",
      "migration_status" : "NO_MIGRATION_NEEDED",
      "indices" : [ ]
    },
    {
      "feature_name" : "transform",
      "minimum_index_version" : "8100099",
      "migration_status" : "NO_MIGRATION_NEEDED",
      "indices" : [ ]
    },
    {
      "feature_name" : "watcher",
      "minimum_index_version" : "8100099",
      "migration_status" : "NO_MIGRATION_NEEDED",
      "indices" : [ ]
    }
  ],
  "migration_status" : "NO_MIGRATION_NEEDED"
}

当您向 _migration/system_features 端点提交 POST 请求以启动迁移过程时，响应会指示将迁移哪些功能。

response = client.migration.post_feature_upgrade
puts response

POST /_migration/system_features

示例响应

{
  "accepted" : true,
  "features" : [
    {
      "feature_name" : "security" 
    }
  ]
}

Elasticsearch 安全功能将在集群升级之前迁移。

后续 GET 请求将返回迁移过程的状态。

« 弃用信息 API 节点生命周期 API »