› › ›

API получения политики жизненного цикла

Получает политику жизненного цикла.

Запрос

GET _ilm/policy

GET _ilm/policy/<policy_id>

Предварительные условия

Если включены функции безопасности Elasticsearch, у вас должны быть разрешения manage_ilm или read_ilm, или оба, для использования этого API. Дополнительную информацию см. в разделе Разрешения безопасности.

Описание

Возвращает указанное определение политики. Включает версию политики и последнюю дату изменения. Если политика не указана, возвращает все определённые политики.

Параметры пути

<policy_id>: (Необязательно, строка) Идентификатор политики.

Параметры запроса

master_timeout: (Необязательно, единицы времени) Время ожидания подключения к мастер-узлу. Если ответ не получен до истечения срока ожидания, запрос завершается ошибкой. По умолчанию 30s.
timeout: (Необязательно, единицы времени) Время ожидания ответа. Если ответ не получен до истечения срока ожидания, запрос завершается ошибкой. По умолчанию 30s.

Примеры

Следующий пример получает my_policy:

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" : []
    }
  }
}

	Версия политики увеличивается при каждом обновлении.
	Последняя дата изменения этой политики.
	Какие индексы, потоки данных или шаблоны в настоящее время используют эту политику.

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/7.17/ilm-get-lifecycle.html