刷新索引
1.0 版引入
刷新索引 API 用于刷新 OpenSearch 集群中的一个或多个索引。对于数据流，刷新索引 API 刷新数据流的后端索引。
OpenSearch 的刷新行为取决于是否设置了 index.refresh_interval
- 如果设置了此项，索引将根据
index.refresh_interval设置（以秒为单位）进行刷新。有关index.refresh_interval设置的更多信息，请参阅动态索引级别索引设置。 - 如果未设置此项，刷新将每秒发生，直到分片在至少由
index.search.idle.after设置（以秒为单位）指定的时间内没有收到搜索请求。默认值为30s。
分片空闲后，索引将不会刷新，直到发送下一个搜索请求或刷新索引 API 请求。对空闲分片的第一个搜索请求将等待刷新操作完成。
要使用刷新索引 API，您必须对要刷新的索引具有写入权限。
端点
POST /_refresh
GET /_refresh
POST /<index>/_refresh
GET /<index>/_refresh
路径参数
下表列出了可用的路径参数。所有路径参数均为可选。
| 参数 | 数据类型 | 描述 |
|---|---|---|
index | 字符串 | 要刷新的索引名称的逗号分隔列表。接受通配符。 |
查询参数
下表列出了可用的查询参数。所有查询参数都是可选的。
| 参数 | 数据类型 | 描述 |
|---|---|---|
ignore_unavailable | 布尔型 | 当为 false 时，如果请求的目标是缺失或已关闭的索引，则会返回错误。默认值为 false。 |
allow_no_indices | 布尔型 | 当为 false 时，即使请求是针对开放索引发出的，如果通配符表达式、索引别名或 _all 只针对已关闭或缺失的索引，刷新索引 API 也会返回错误。默认值为 true。 |
expand_wildcards | 字符串 | 通配符模式可以匹配的索引类型。如果请求的目标是数据流，此参数决定通配符表达式是否匹配任何隐藏的数据流。支持逗号分隔值，例如 open,hidden。有效值为 all、open、closed、hidden 和 none。 |
示例请求
刷新多个数据流或索引
以下示例请求刷新两个名为 my-index-A 和 my-index-B 的索引
POST /my-index-A,my-index-B/_refresh
刷新集群中的所有数据流和索引
以下请求刷新集群中的所有数据流和索引
POST /_refresh