Refreshes one or more indices.
Use the refresh API to explicitly refresh one or more indices. A refresh makes all operations performed on an index since the last refresh available for search.
By default, Elasticsearch periodically refreshes indices every second, but only on
indices that have received one search request or more in the last 30 seconds.
You can change this default interval
Refreshes are a resource-intensive. To ensure good cluster performance, we recommend waiting for Elasticsearch’s periodic refresh rather than performing an explicit refresh when possible.
If your application workflow
indexes documents and then runs a search
to retrieve the indexed document,
we recommend using the index API's
refresh=wait_for query parameter option.
This option ensures the indexing operation waits
for a periodic refresh
before running the search.
(Optional, string) Comma-separated list or wildcard expression of index names used to limit the request.
To refresh all indices in the cluster, omit this parameter or use a value of
(Optional, boolean) If
true, the request does not return an error if a wildcard expression or
_allvalue retrieves only missing or closed indices.
This parameter also applies to index aliases that point to a missing or closed index.
(Optional, string) Controls what kind of indices that wildcard expressions can expand to. Valid values are:
- Expand to open and closed indices.
- Expand only to open indices.
- Expand only to closed indices.
- Wildcard expressions are not accepted.
- (Optional, boolean) If
true, missing or closed indices are not included in the response. Defaults to