You're viewing version 2.16 of the OpenSearch documentation. This version is no longer maintained. For the latest version, see the current documentation. For information about OpenSearch version maintenance, see Release Schedule and Maintenance Policy.

Managed indexes

You can change or update a policy using the managed index operations.

This table lists the fields of managed index operations.

Parameter	Description	Type	Required	Read Only
`name`	The name of the managed index policy.	`string`	Yes	No
`index`	The name of the managed index that this policy is managing.	`string`	Yes	No
`index_uuid`	The uuid of the index.	`string`	Yes	No
`enabled`	When `true`, the managed index is scheduled and run by the scheduler.	`boolean`	Yes	No
`enabled_time`	The time the managed index was last enabled. If the managed index process is disabled, then this is null.	`timestamp`	Yes	Yes
`last_updated_time`	The time the managed index was last updated.	`timestamp`	Yes	Yes
`schedule`	The schedule of the managed index job.	`object`	Yes	No
`policy_id`	The name of the policy used by this managed index.	`string`	Yes	No
`policy_seq_no`	The sequence number of the policy used by this managed index.	`number`	Yes	No
`policy_primary_term`	The primary term of the policy used by this managed index.	`number`	Yes	No
`policy_version`	The version of the policy used by this managed index.	`number`	Yes	Yes
`policy`	The cached JSON of the policy for the `policy_version` that’s used during runs. If the policy is null, it means that this is the first execution of the job and the latest policy document is read in/saved.	`object`	No	No
`change_policy`	The information regarding what policy and state to change to.	`object`	No	No
`policy_name`	The name of the policy to update to. To update to the latest version, set this to be the same as the current `policy_name`.	`string`	No	Yes
`state`	The state of the managed index after it finishes updating. If no state is specified, it’s assumed that the policy structure did not change.	`string`	No	Yes

The following example shows a managed index policy:

{
  "managed_index": {
    "name": "my_index",
    "index": "my_index",
    "index_uuid": "sOKSOfkdsoSKeofjIS",
    "enabled": true,
    "enabled_time": 1553112384,
    "last_updated_time": 1553112384,
    "schedule": {
      "interval": {
        "period": 1,
        "unit": "MINUTES",
        "start_time": 1553112384
      }
    },
    "policy_id": "log_rotation",
    "policy_version": 1,
    "policy": {...},
    "change_policy": null
  }
}

Change policy

You can change any managed index policy, but ISM has a few constraints in place to make sure that policy changes don’t break indexes.

If an index is stuck in its current state, never proceeding, and you want to update its policy immediately, make sure that the new policy includes the same state—same name, same actions, same order—as the old policy. In this case, even if the policy is in the middle of executing an action, ISM applies the new policy.

If you update the policy without including an identical state, ISM updates the policy only after all actions in the current state finish executing. Alternately, you can choose a specific state in your old policy after which you want the new policy to take effect.

To change a policy using OpenSearch Dashboards, do the following:

Under Index Management, choose the indexes that you want to attach the new policy to.
To attach the new policy to indexes in specific states, choose Choose state filters, and then choose those states.
Under Choose New Policy, choose the new policy.
To start the new policy for indexes in the current state, choose Keep indices in their current state after the policy takes effect.
To start the new policy in a specific state, choose Start from a chosen state after changing policies, and then choose the default start state in your new policy.