Execute snapshot retention policy API

Deletes any snapshots that are expired according to the policy’s retention rules.

Request

POST /_slm/_execute_retention

Prerequisites

If the Elasticsearch security features are enabled, you must have the manage_slm cluster privilege to use this API. For more information, see Security privileges.

Description

Manually applies the retention policy to force immediate removal of expired snapshots. The retention policy is normally applied according to its schedule.

Examples

To force removal of expired snapshots:

resp = client.slm.execute_retention()
print(resp)
response = client.slm.execute_retention
puts response
const response = await client.slm.executeRetention();
console.log(response);
POST /_slm/_execute_retention

Retention runs asynchronously in the background.