ISM error prevention

Error prevention validates Index State Management (ISM) actions before they are performed in order to prevent actions from failing. It also outputs additional information from the action validation results in the response of the Index Explain API. Validation rules and troubleshooting of each action are listed in the following sections.

---

Table of contents

1. Roll over
2. Delete
3. Force merge
4. Replica count
5. Open
6. Read only
7. Read write
8. Close
9. Index priority
10. Snapshot
11. Search only
12. Transition

---

Roll over

ISM does not perform a rollover action for an index under any of these conditions:

• The index is not the write index.
• The index does not have an alias.
• The rollover policy does not contain a rollover_alias index setting.
• Skipping of a rollover action has occurred.
• The index has already been rolled over using the alias successfully.

Delete

ISM does not perform a delete action for an index under any of these conditions:

• The index does not exist.
• The index name is invalid.
• The index is the write index for a data stream.

Force merge

ISM does not perform a force_merge action for an index if its dataset is too large and exceeds the threshold.

Replica count

ISM does not perform a replica_count action for an index under any of these conditions:

• The amount of data exceeds the threshold.
• The number of shards exceeds the maximum.

Open

ISM does not perform an open action for an index under any of these conditions:

• The index is blocked.
• The number of shards exceeds the maximum.

Read only

ISM does not perform a read_only action for an index under any of these conditions:

• The index is blocked.
• The amount of data exceeds the threshold.

Read write

ISM does not perform a read_write action for an index if the index is blocked.

Close

ISM does not perform a close action for an index under any of these conditions:

• The index does not exist.
• The index name is invalid.

Index priority

ISM does not perform an index_priority action for an index that does not have read-only-allow-delete permission.

Snapshot

ISM does not perform a snapshot action for an index under any of these conditions:

• The index does not exist.
• The index name is invalid.

Search only

ISM does not perform a search_only action for an index under any of these conditions:

• The index does not exist.
• Remote store is not enabled on the cluster.
• Segment replication is not enabled for the index.
• No search replicas are configured for the index.

Transition

ISM does not perform a transition action for an index under any of these conditions:

• The index does not exist.
• The index name is invalid.