Remove policy from index API

edit

Removes the assigned lifecycle policy from an index.

Request

edit

POST <index>/_ilm/remove

Prerequisites

edit
  • If the Elasticsearch security features are enabled, you must have the manage_ilm privileges on the indices being managed to use this API. For more information, see Security privileges.

Description

edit

Removes the assigned lifecycle policy and stops managing the specified index. If an index pattern is specified, removes the assigned policies from all matching indices.

Path parameters

edit
<index>
(Required, string) Identifier for the index.

Query parameters

edit
timeout
(Optional, time units) Specifies the period of time to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. Defaults to 30s.
master_timeout
(Optional, time units) Specifies the period of time 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. Defaults to 30s.

Examples

edit

The following example removes the assigned policy from my_index.

POST my_index/_ilm/remove

If the request succeeds, you receive the following result:

{
  "has_failures" : false,
  "failed_indexes" : []
}