功能 API

edit

您可以使用以下API来内省和管理由Elasticsearch及其插件提供的功能。

功能 API

edit

获取特征 API

edit

获取可以使用feature_states 字段在创建快照时包含的功能列表。

GET /_features

请求

edit

GET /_features

描述

edit

您可以使用获取功能 API 来确定在创建快照时包含哪些功能状态。默认情况下,如果快照包含全局状态,则所有功能状态都会包含在快照中,否则不包含任何功能状态。

一个功能状态包括一个或多个系统索引,这些索引对于给定功能的正常运行是必要的。为了确保数据完整性,构成功能状态的所有系统索引都会一起进行快照和恢复。

此API列出的功能是内置功能和插件定义功能的组合。为了使功能的状态能够在此API中列出,并被创建快照API识别为有效的功能状态,定义该功能的插件必须安装在主节点上。

示例

edit
{
    "features": [
        {
            "name": "tasks",
            "description": "Manages task results"
        },
        {
            "name": "kibana",
            "description": "Manages Kibana configuration and reports"
        }
    ]
}

重置功能 API

edit

此功能处于技术预览阶段,可能会在未来的版本中进行更改或移除。Elastic 将努力修复任何问题,但技术预览版中的功能不受官方 GA 功能支持 SLA 的约束。

清除Elasticsearch功能存储在系统索引中的所有状态信息,包括安全性和机器学习索引。

仅用于开发和测试目的。请勿在生产集群上重置功能。

POST /_features/_reset

请求

edit

POST /_features/_reset

描述

edit

通过重置所有 Elasticsearch 功能的状态,将集群恢复到与新安装相同的状态。这将删除存储在系统索引中的所有状态信息。

如果所有功能的状成功重置,响应代码为HTTP 200;如果任何功能的重置操作失败,响应代码为HTTP 500

请注意,选择功能可能会提供一种重置特定系统索引的方法。使用此API会重置所有功能,包括那些内置的和作为插件实现的功能。

要列出将受影响的特性,请使用获取特性API

您提交此请求的节点上安装的功能将是将被重置的功能。如果您对各个节点上安装的插件有任何疑问,请在主节点上运行。

查询参数

edit
master_timeout
(可选,时间单位) 等待主节点的时间段。如果在超时到期之前主节点不可用,请求将失败并返回错误。默认为30s。 也可以设置为-1,表示请求不应超时。

示例

edit

示例响应:

{
  "features" : [
    {
      "feature_name" : "security",
      "status" : "SUCCESS"
    },
    {
      "feature_name" : "tasks",
      "status" : "SUCCESS"
    }
  ]
}