配置项作用 #
index_state_management.allow_list 配置项控制 ISM 策略中允许执行的操作类型，用于限制可用的 ISM 操作。
是否可选 #
是
默认值 #
[alias, allocation, close, delete, force_merge, index_priority, open, read_only, read_write, replica_count, rollup, rollover, shrink, snapshot, wait_for_snapshot]
配置项类型 #
动态配置 - 可以在运行时修改
配置格式 #
# 默认配置（允许所有操作）
index_state_management.allow_list:
- alias
- allocation
- close
- delete
- force_merge
- index_priority
- open
- read_only
- read_write
- replica_count
- rollup
- rollover
- shrink
- snapshot
- wait_for_snapshot
# 限制允许的操作
index_state_management.allow_list:
- rollover
- delete
- snapshot
# 只允许只读操作
index_state_management.allow_list:
- close
- open
- read_only
- read_write
可用操作说明 #
| 操作 | 说明 | 风险级别 |
|---|---|---|
alias | 管理索引别名 | 低 |
allocation | 修改分片分配 | 中 |
close | 关闭索引 | 低 |
delete | 删除索引 | 高 |
force_merge | 强制合并 | 中 |
open | 打开索引 | 低 |
read_only | 设为只读 | 低 |
read_write | 设为可写 | 低 |
replica_count | 修改副本数 | 中 |
rollover | 滚动索引 | 低 |
shrink | 收缩索引 | 中 |
snapshot | 创建快照 | 低 |
wait_for_snapshot | 等待快照完成 | 低 |
index_priority | 设置索引优先级 | 低 |
rollup | 汇总数据 | 中 |
推荐设置 #
| 环境 | 推荐值 | 说明 |
|---|---|---|
| 默认配置 | 所有操作 | 完整功能 |
| 只读环境 | 只读操作 | 防止修改 |
| 安全优先 | 排除危险操作 | 限制删除等 |
使用示例 #
默认配置：
index_state_management.allow_list:
- alias
- allocation
- close
- delete
- force_merge
- index_priority
- open
- read_only
- read_write
- replica_count
- rollup
- rollover
- shrink
- snapshot
- wait_for_snapshot
安全配置（排除危险操作）：
index_state_management.allow_list:
- rollover
- close
- open
- read_only
- read_write
- replica_count
- snapshot
只读操作配置：
index_state_management.allow_list:
- close
- open
- read_only
- read_write
配置验证 #
# 查看当前配置
GET /_cluster/settings?filter_path=*.index_state_management.allow_list
# 测试策略执行
PUT _policies/test_policy
{
"policy": {
"states": [
{
"name": "hot",
"actions": [
{"rollover": {"max_age": "1d"}}
]
}
]
}
}
常见问题 #
问题 1：操作不被允许
错误信息：
illegal_argument_exception: operation [delete] is not allowed
解决方案：
# 添加允许的操作
index_state_management.allow_list:
- delete
问题 2：安全顾虑
解决方案：
# 排除危险操作
index_state_management.allow_list:
- rollover
- close
- snapshot
注意事项 #
- 动态配置：可以在运行时修改
- 白名单机制：只允许列表中的操作
- 安全考虑：生产环境应排除危险操作
- 策略限制：策略中的操作必须在允许列表中
- 默认值：默认允许所有操作
相关配置项 #
| 配置项 | 默认值 | 说明 |
|---|---|---|
index_state_management.enabled | true | 是否启用 ISM |
index_state_management.action_validation.enabled | false | 是否启用操作验证 |
完整配置示例 #
# easysearch.yml
# 安全配置（排除危险操作）
index_state_management.enabled: true
index_state_management.allow_list:
- alias
- close
- open
- read_only
- read_write
- replica_count
- rollover
- snapshot
