97 lines
2.1 KiB
Plaintext
97 lines
2.1 KiB
Plaintext
[role="xpack"]
|
|
[testenv="basic"]
|
|
[[ilm-stop]]
|
|
=== Stop {ilm} API
|
|
|
|
[subs="attributes"]
|
|
++++
|
|
<titleabbrev>Stop {ilm}</titleabbrev>
|
|
++++
|
|
|
|
Stop the {ilm} ({ilm-init}) plugin.
|
|
|
|
==== Request
|
|
|
|
`POST /_ilm/stop`
|
|
|
|
==== Description
|
|
|
|
Halts all lifecycle management operations and stops the {ilm-init} plugin. This
|
|
is useful when you are performing maintenance on the cluster and need to prevent
|
|
{ilm-init} from performing any actions on your indices.
|
|
|
|
The API returns as soon as the stop request has been acknowledged, but the
|
|
plugin might continue to run until in-progress operations complete and the plugin
|
|
can be safely stopped. Use the <<ilm-get-status, Get ILM Status>> API to see
|
|
if {ilm-init} is running.
|
|
|
|
==== Request Parameters
|
|
|
|
include::{docdir}/rest-api/common-parms.asciidoc[tag=timeoutparms]
|
|
|
|
==== Authorization
|
|
|
|
You must have the `manage_ilm` cluster privilege to use this API.
|
|
For more information, see <<security-privileges>>.
|
|
|
|
==== Examples
|
|
|
|
The following example stops the ILM plugin.
|
|
|
|
//////////////////////////
|
|
|
|
[source,console]
|
|
--------------------------------------------------
|
|
PUT _ilm/policy/my_policy
|
|
{
|
|
"policy": {
|
|
"phases": {
|
|
"warm": {
|
|
"min_age": "10d",
|
|
"actions": {
|
|
"forcemerge": {
|
|
"max_num_segments": 1
|
|
}
|
|
}
|
|
},
|
|
"delete": {
|
|
"min_age": "30d",
|
|
"actions": {
|
|
"delete": {}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
PUT my_index
|
|
--------------------------------------------------
|
|
// TEST
|
|
|
|
//////////////////////////
|
|
|
|
[source,console]
|
|
--------------------------------------------------
|
|
POST _ilm/stop
|
|
--------------------------------------------------
|
|
// TEST[continued]
|
|
|
|
If the request does not encounter errors, you receive the following result:
|
|
|
|
[source,console-result]
|
|
--------------------------------------------------
|
|
{
|
|
"acknowledged": true
|
|
}
|
|
--------------------------------------------------
|
|
|
|
//////////////////////////
|
|
|
|
[source,console]
|
|
--------------------------------------------------
|
|
POST _ilm/start
|
|
--------------------------------------------------
|
|
// TEST[continued]
|
|
|
|
//////////////////////////
|