---
title: "索引状态管理受限索引模式配置"
date: 2026-03-06
lastmod: 2026-03-06
description: "index_state_management.restricted_index_pattern 配置项用于定义不允许被索引状态管理（ISM）策略管理的索引模式。"
tags: ["索引状态管理", "ISM", "索引限制", "正则表达式"]
summary: "配置项作用 #  index_state_management.restricted_index_pattern 配置项用于定义不允许被索引状态管理（ISM）策略管理的索引模式。
配置项属性 #   配置路径: index_state_management.restricted_index_pattern 数据类型: String（字符串，正则表达式模式） 默认值: \.easysearch_security|\.kibana.*|\\$INDEX_MANAGEMENT_INDEX 是否可选: 是 作用域: NodeScope（节点级别） 动态更新: 是（可以动态更新，无需重启） 废弃状态: LegacyManagedIndexSettings 中标记为废弃，但 ManagedIndexSettings 中未废弃  配置建议 #  默认配置 #  index_state_management: restricted_index_pattern: "\.easysearch_security|\.kibana.*|\\$INDEX_MANAGEMENT_INDEX" 自定义受限模式 #  index_state_management: restricted_index_pattern: "\.easysearch_security|\.kibana.*|\.system.*|\\$INDEX_MANAGEMENT_INDEX" 空模式（不限制任何索引） #  index_state_management: restricted_index_pattern: "" 默认受限索引 #  默认情况下，以下索引模式受到保护，不会被 ISM 策略管理：
 .easysearch_security - Easysearch 安全相关索引 .kibana.* - Kibana 相关索引 $INDEX_MANAGEMENT_INDEX - ISM 管理索引本身  功能说明 #  保护机制 #  此配置通过正则表达式模式匹配来防止关键系统索引被 ISM 策略意外管理，避免以下风险："
---


## 配置项作用

`index_state_management.restricted_index_pattern` 配置项用于**定义不允许被索引状态管理（ISM）策略管理的索引模式**。

## 配置项属性

- **配置路径**: `index_state_management.restricted_index_pattern`
- **数据类型**: `String`（字符串，正则表达式模式）
- **默认值**: `\.easysearch_security|\.kibana.*|\\$INDEX_MANAGEMENT_INDEX`
- **是否可选**: 是
- **作用域**: NodeScope（节点级别）
- **动态更新**: 是（可以动态更新，无需重启）
- **废弃状态**: LegacyManagedIndexSettings 中标记为废弃，但 ManagedIndexSettings 中未废弃

## 配置建议

## 默认配置

```yaml
index_state_management:
  restricted_index_pattern: "\.easysearch_security|\.kibana.*|\\$INDEX_MANAGEMENT_INDEX"
```

## 自定义受限模式

```yaml
index_state_management:
  restricted_index_pattern: "\.easysearch_security|\.kibana.*|\.system.*|\\$INDEX_MANAGEMENT_INDEX"
```

## 空模式（不限制任何索引）

```yaml
index_state_management:
  restricted_index_pattern: ""
```

## 默认受限索引

默认情况下，以下索引模式受到保护，不会被 ISM 策略管理：

1. **`.easysearch_security`** - Easysearch 安全相关索引
2. **`.kibana.*`** - Kibana 相关索引
3. **`$INDEX_MANAGEMENT_INDEX`** - ISM 管理索引本身

## 功能说明

## 保护机制

此配置通过正则表达式模式匹配来防止关键系统索引被 ISM 策略意外管理，避免以下风险：
- 系统索引被意外删除或滚动
- 关键配置数据丢失
- ISM 功能本身受到影响

## 模式匹配

- 使用正则表达式语法
- 支持多个模式，用 `|` 分隔
- 模式区分大小写

## 使用建议

## 添加系统索引

```yaml
index_state_management:
  restricted_index_pattern: "\.easysearch_security|\.kibana.*|\.monitoring.*|\.alerts.*|\\$INDEX_MANAGEMENT_INDEX"
```

## 保护自定义系统索引

```yaml
index_state_management:
  restricted_index_pattern: "\.easysearch_security|\.kibana.*|\.myapp_system.*|\\$INDEX_MANAGEMENT_INDEX"
```

## 注意事项

1. **动态更新**: 此配置可以动态更新，无需重启节点。

2. **安全考虑**: 保持关键系统索引在受限列表中，防止被 ISM 策略误操作。

3. **正则语法**: 确保使用正确的正则表达式语法，错误可能导致意外的匹配结果。

4. **测试验证**: 在生产环境中应用前，建议在测试环境验证模式是否正确匹配预期索引。

5. **IAM 索引**: ISM 管理索引本身始终应保持在受限列表中。

6. **备份配置**: 修改此配置前，建议备份原始配置以便需要时恢复。

7. **默认模式**: 对于大多数场景，默认配置已经提供了足够的保护，无需额外修改。