扩缩
3.0 版本引入
扩展 API 允许您在索引上启用或禁用 search_only
模式。当索引处于 search_only
模式时,它仅保留其搜索副本,并缩减主分片和常规副本分片。这种优化有助于在写入活动较低的时期减少资源消耗,同时保持搜索功能。
此功能支持诸如缩放到零部署和读/写分离模式等场景,可以显著提高生产环境中的资源利用率并降低成本。
如果您正在使用安全插件,则必须拥有 manage index
权限。
端点
POST /<index>/_scale
路径参数
下表列出了可用的路径参数。
参数 | 必需 | 数据类型 | 描述 |
---|---|---|---|
索引 | 必需 | 字符串 | 要扩展的索引名称。不支持通配符。 |
请求正文字段
下表列出了可用的请求正文字段。
字段 | 必需 | 数据类型 | 描述 |
---|---|---|---|
search_only | 必需 | 布尔型 | 当为 true 时,在索引上启用只读模式。当为 false 时,禁用只读模式并将索引恢复到正常操作。 |
示例请求
启用只读模式
以下请求为名为 my-index
的索引启用只读模式
POST /my-index/_scale
{
"search_only": true
}
禁用只读模式
以下请求禁用只读模式并将索引恢复到正常操作
POST /my-index/_scale
{
"search_only": false
}
示例响应
API 返回以下响应
{
"acknowledged": true
}