[role="xpack"]
[testenv="basic"]
[[ilm-put-lifecycle]]
=== Create Lifecycle Policy API
++++
Create Policy
++++
beta[]
Creates or updates lifecycle policy.
==== Request
`PUT _ilm/policy/`
==== Description
Creates a lifecycle policy. If the specified policy exists, the policy is
replaced and the policy version is incremented.
NOTE: Only the latest version of the policy is stored, you cannot revert to
previous versions.
==== Path Parameters
`policy` (required)::
(string) Identifier for the policy.
==== Request Parameters
include::{docdir}/rest-api/timeoutparms.asciidoc[]
==== Authorization
You must have the `manage_ilm` cluster privilege to use this API. You must
also have the `manage` index privilege on all indices being managed by `policy`.
All operations executed by {Ilm} for a policy are executed as the user that
put the latest version of a policy.
For more information, see {stack-ov}/security-privileges.html[Security Privileges].
==== Examples
The following example creates a new policy named `my_policy`:
[source,js]
--------------------------------------------------
PUT _ilm/policy/my_policy
{
"policy": {
"phases": {
"warm": {
"min_age": "10d",
"actions": {
"forcemerge": {
"max_num_segments": 1
}
}
},
"delete": {
"min_age": "30d",
"actions": {
"delete": {}
}
}
}
}
}
--------------------------------------------------
// CONSOLE
// TEST
If the request succeeds, you receive the following result:
[source,js]
----
{
"acknowledged": true
}
----
// CONSOLE
// TESTRESPONSE