Execute snapshot retention policy API

edit

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

Request

edit

POST /_slm/_execute_retention

Prerequisites

edit

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

edit

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

Examples

edit

To force removal of expired snapshots:

response = client.slm.execute_retention
puts response
POST /_slm/_execute_retention

Retention runs asynchronously in the background.