› › ›

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

Получает одну или несколько определений политики жизненного цикла снимков и информацию о последних попытках создания снимков.

Запрос

GET _slm/policy/<policy-id>

GET _slm/policy

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

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

Описание

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

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

<policy-id>: (Необязательно, строка) Список идентификаторов политик жизненного цикла снимков, разделенных запятыми.

Примеры

Получение определенной политики

Получение политики daily-snapshots:

resp = client.slm.get_lifecycle(
    policy_id="daily-snapshots",
    human=True,
)
print(resp)

response = client.slm.get_lifecycle(
  policy_id: 'daily-snapshots',
  human: true
)
puts response

const response = await client.slm.getLifecycle({
  policy_id: "daily-snapshots",
  human: "true",
});
console.log(response);

GET _slm/policy/daily-snapshots?human

Этот запрос возвращает следующий ответ:

{
  "daily-snapshots": {
    "version": 1,                                 
    "modified_date": "2099-05-06T01:30:00.000Z",  
    "modified_date_millis": 4081757400000,
    "policy" : {
      "schedule": "0 30 1 * * ?",
      "name": "<daily-snap-{now/d}>",
      "repository": "my_repository",
      "config": {
        "indices": ["data-*", "important"],
        "ignore_unavailable": false,
        "include_global_state": false
      },
      "retention": {
        "expire_after": "30d",
        "min_count": 5,
        "max_count": 50
      }
    },
    "stats": {
      "policy": "daily-snapshots",
      "snapshots_taken": 0,
      "snapshots_failed": 0,
      "snapshots_deleted": 0,
      "snapshot_deletion_failures": 0
    },
    "next_execution": "2099-05-07T01:30:00.000Z", 
    "next_execution_millis": 4081843800000
  }
}

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

Получение всех политик

resp = client.slm.get_lifecycle()
print(resp)

response = client.slm.get_lifecycle
puts response

const response = await client.slm.getLifecycle();
console.log(response);

GET _slm/policy

© 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/8.17/slm-api-get-policy.html