This version of the OpenSearch documentation is no longer maintained. For the latest version, see the current documentation. For information about OpenSearch version maintenance, see Release Schedule and Maintenance Policy.
Close index
Introduced 1.0
The close index API operation closes an index. Once an index is closed, you cannot add data to it or search for any data within the index.
Example
POST /sample-index/_close
copy
Path and HTTP methods
POST /<index-name>/_close
URL parameters
All parameters are optional.
Parameter | Type | Description |
---|---|---|
<index-name> | String | The index to close. Can be a comma-separated list of multiple index names. Use _all or * to close all indexes. |
allow_no_indices | Boolean | Whether to ignore wildcards that don’t match any indexes. Default is true. |
expand_wildcards | String | Expands wildcard expressions to different indexes. Combine multiple values with commas. Available values are all (match all indexes), open (match open indexes), closed (match closed indexes), hidden (match hidden indexes), and none (do not accept wildcard expressions). Default is open. |
ignore_unavailable | Boolean | If true, OpenSearch does not search for missing or closed indexes. Default is false. |
wait_for_active_shards | String | Specifies the number of active shards that must be available before OpenSearch processes the request. Default is 1 (only the primary shard). Set to all or a positive integer. Values greater than 1 require replicas. For example, if you specify a value of 3, the index must have two replicas distributed across two additional nodes for the request to succeed. |
cluster_manager_timeout | Time | How long to wait for a connection to the cluster manager node. Default is 30s . |
timeout | Time | How long to wait for a response from the cluster. Default is 30s . |
Response
{
"acknowledged": true,
"shards_acknowledged": true,
"indices": {
"sample-index1": {
"closed": true
}
}
}
当前内容版权归 OpenSearch 或其关联方所有,如需对内容或内容相关联开源项目进行关注与资助,请访问 OpenSearch .