Elasticsearch - 管理索引生命周期
管理索引生命周期涉及根据分片大小和性能要求等因素执行管理操作。索引生命周期管理 (ILM) API 使您能够自动管理随时间推移的索引。
本章列出了 ILM API 及其用法。
策略管理 API
API 名称 |
用途 |
示例 |
创建生命周期策略。 |
创建生命周期策略。如果指定策略存在,则替换该策略并增加策略版本。 |
PUT_ilm/policy/policy_id |
获取生命周期策略。 |
返回指定的策略定义。包括策略版本和上次修改日期。如果未指定策略,则返回所有定义的策略。 |
GET_ilm/policy/policy_id |
删除生命周期策略 |
删除指定的生命周期策略定义。您无法删除当前正在使用的策略。如果该策略正在用于管理任何索引,则请求失败并返回错误。 |
DELETE_ilm/policy/policy_id |
索引管理 API
API 名称 |
用途 |
示例 |
移至生命周期步骤 API。 |
手动将索引移至指定步骤并执行该步骤。 |
POST_ilm/move/index |
重试策略。 |
将策略设置回发生错误的步骤并执行该步骤。 |
POST index/_ilm/retry |
从索引 API 编辑中删除策略。 |
删除分配的生命周期策略并停止管理指定的索引。如果指定了索引模式,则从所有匹配的索引中删除已分配的策略。 |
POST index/_ilm/remove |
操作管理 API
API 名称 |
用途 |
示例 |
获取索引生命周期管理状态 API。 |
返回 ILM 插件的状态。响应中的 operation_mode 字段显示以下三种状态之一:STARTED、STOPPING 或 STOPPED。 |
GET /_ilm/status |
启动索引生命周期管理 API。 |
如果 ILM 插件当前已停止,则启动它。集群形成时,ILM 会自动启动。
|
POST /_ilm/start |
停止索引生命周期管理 API。 |
停止所有生命周期管理操作并停止 ILM 插件。当您在集群上执行维护并且需要阻止 ILM 对您的索引执行任何操作时,这很有用。 |
POST /_ilm/stop |
解释生命周期 API。 |
检索有关索引当前生命周期状态的信息,例如当前正在执行的阶段、操作和步骤。显示索引进入每个阶段的时间、正在运行的阶段的定义以及有关任何故障的信息。 |
GET index/_ilm/explain |