配置项概述 #
rest.action.multi.allow_explicit_index 配置控制是否在批量操作（Bulk）、多搜索（Multi-Search）和多获取（Multi-Get）请求的请求体中显式指定索引名称。
| 配置项 | 默认值 | 说明 |
|---|---|---|
rest.action.multi.allow_explicit_index | true | 允许在请求体中显式指定索引 |
配置说明 #
rest.action.multi.allow_explicit_index #
配置项作用：控制是否在多操作请求的请求体中允许显式指定索引名称。
默认值：true
配置类型：静态配置（需要重启节点）
取值范围：
true：允许在请求体中显式指定索引（默认）false：禁止在请求体中显式指定索引
配置格式：
# 默认配置：允许显式索引
rest.action.multi.allow_explicit_index: true
# 禁止显式索引
rest.action.multi.allow_explicit_index: false
影响的操作 #
该配置影响以下三个主要的 API：
1. 多搜索 API (_msearch)
#
当设置为 false 时，禁止在搜索请求元数据中指定索引：
# 当 allow_explicit_index=false 时，此请求将失败
POST /_msearch
{"index": "my-index"}
{"query": {"match_all": {}}}
正确的方式是在 URL 中指定索引：
# 正确的方式
POST /my-index/_msearch
{}
{"query": {"match_all": {}}}
2. 多获取 API (_mget)
#
当设置为 false 时，禁止在文档请求中指定 _index：
# 当 allow_explicit_index=false 时，此请求将失败
POST /_mget
{"docs": [{"_index": "my-index", "_id": "1"}]}
正确的方式：
# 正确的方式
POST /my-index/_mget
{"docs": [{"_id": "1"}]}
3. 批量 API (_bulk)
#
当设置为 false 时，禁止在操作元数据中指定 _index：
# 当 allow_explicit_index=false 时，此请求将失败
POST /_bulk
{"index": {"_index": "my-index", "_id": "1"}}
{"field": "value"}
正确的方式：
# 正确的方式
POST /my-index/_bulk
{"index": {"_id": "1"}}
{"field": "value"}
使用场景 #
安全控制场景 #
设置为 false 的场景：
- 防止索引路由攻击：阻止恶意用户尝试将文档路由到未授权的索引
- 简化权限管理：强制所有操作使用 URL 中预定义的索引，便于权限控制
- 合规要求：满足某些安全规范对索引访问方式的限制
示例配置：
# 生产环境安全配置
rest.action.multi.allow_explicit_index: false
灵活性场景 #
设置为 true 的场景（默认）：
- 混合索引操作：需要在单个批量请求中操作多个索引
- 动态路由：根据文档内容动态决定目标索引
- 遗留应用兼容：许多现有应用依赖在请求体中指定索引
示例配置：
# 默认配置，保持灵活性
rest.action.multi.allow_explicit_index: true
错误处理 #
当 allow_explicit_index 设置为 false 且请求中包含显式索引时，将返回以下错误：
Multi-Search 错误：
{
"error": {
"type": "illegal_argument_exception",
"reason": "explicit index in multi search is not allowed"
}
}
Multi-Get 错误：
{
"error": {
"type": "illegal_argument_exception",
"reason": "explicit index in multi get is not allowed"
}
}
Bulk 错误：
{
"error": {
"type": "illegal_argument_exception",
"reason": "explicit index in bulk is not allowed"
}
}
推荐配置 #
生产环境安全配置 #
# 禁用显式索引，增强安全性
rest.action.multi.allow_explicit_index: false
开发/测试环境 #
# 保持默认，便于开发调试
rest.action.multi.allow_explicit_index: true
注意事项 #
- 重启生效：修改此配置需要重启节点才能生效
- 破坏性变更：设置为
false可能导致现有应用无法正常工作 - 配合使用：建议与其他安全配置（如 SSL/TLS、身份验证）配合使用
- 渐进式部署：在禁用前，应先测试并更新所有客户端代码
