Run a retention policy Added in 7.5.0

POST /_slm/_execute_retention
Api key auth Basic auth Bearer auth

Manually apply the retention policy to force immediate removal of snapshots that are expired according to the snapshot lifecycle policy retention rules. The retention policy is normally applied according to its schedule.

Query parameters

  • master_timeout string

    The period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error.

  • timeout string

    The period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.

Responses

  • 200 application/json
    Hide response attribute Show response attribute object
    • acknowledged boolean Required

      For a successful response, this value is always true. On failure, an exception is returned instead.
POST /_slm/_execute_retention 
curl \
 --request POST http://api.example.com/_slm/_execute_retention \
 --header "Authorization: $API_KEY"
Response examples (200) 
{
  "acknowledged": true
}