获取生命周期策略 API编辑

检索生命周期策略。

请求编辑

GET _ilm/policy

GET _ilm/policy/<policy_id>

先决条件编辑

  • 如果启用了 Elasticsearch 安全功能,则您必须具有 manage_ilmread_ilm 集群权限(或两者)才能使用此 API。有关更多信息,请参阅安全权限

描述编辑

返回指定的策略定义。包括策略版本和上次修改日期。如果未指定策略,则返回所有已定义的策略。

路径参数编辑

<policy_id>
(可选,字符串)策略的标识符。

查询参数编辑

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

示例编辑

以下示例检索 my_policy

response = client.ilm.get_lifecycle(
  policy: 'my_policy'
)
puts response
GET _ilm/policy/my_policy

如果请求成功,则响应正文包含策略定义

{
  "my_policy": {
    "version": 1, 
    "modified_date": 82392349, 
    "policy": {
      "phases": {
        "warm": {
          "min_age": "10d",
          "actions": {
            "forcemerge": {
              "max_num_segments": 1
            }
          }
        },
        "delete": {
          "min_age": "30d",
          "actions": {
            "delete": {
              "delete_searchable_snapshot": true
            }
          }
        }
      }
    },
    "in_use_by" : { 
      "indices" : [],
      "data_streams" : [],
      "composable_templates" : []
    }
  }
}

策略版本在每次更新策略时都会递增

此策略的上次修改时间

当前使用此策略的索引、数据流或模板