Get index lifecycle management status APIedit
Retrieves the current index lifecycle management (ILM) status.
You can start or stop ILM with the start ILM and stop ILM APIs.
Requestedit
GET /_ilm/status
Prerequisitesedit
-
If the Elasticsearch security features are enabled, you must have the
manage_ilm
orread_ilm
or both cluster privileges to use this API. For more information, see Security privileges.
Query parametersedit
-
master_timeout
-
(Optional, time units)
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. Defaults to
30s
. -
timeout
-
(Optional, time units)
Period to wait for a response. If no response is received before the timeout
expires, the request fails and returns an error. Defaults to
30s
.
Response bodyedit
-
operation_mode
-
(string) Current operation mode for ILM.
Possible values for
operation_mode
-
RUNNING
- ILM is running.
-
STOPPING
-
ILM is finishing sensitive actions, such as shrink, that
are in progress. When these actions finish, ILM will move to
STOPPED
. -
STOPPED
- ILM is not running.
-
Examplesedit
The following example gets the ILM plugin status.
GET _ilm/status
If the request succeeds, the body of the response shows the operation mode:
{ "operation_mode": "RUNNING" }