Delete expired data API

edit

Deletes expired and unused machine learning data.

Request

edit

DELETE _ml/_delete_expired_data

Prerequisites

edit
  • If the Elasticsearch security features are enabled, you must have manage_ml or manage cluster privileges to use this API. See Security privileges.

Description

edit

Deletes all job results, model snapshots and forecast data that have exceeded their retention days period. Machine learning state documents that are not associated with any job are also deleted.

Request body

edit
requests_per_second
(Optional, float) The desired requests per second for the deletion processes. The default behavior is no throttling.
timeout
(Optional, string) How long can the underlying delete processes run until they are canceled. The default value is 8h (8 hours).

Examples

edit

The endpoint takes no arguments:

DELETE _ml/_delete_expired_data

When the expired data is deleted, you receive the following response:

{
  "deleted": true
}