Delete index API
editDelete index API
editDeletes an existing index.
DELETE /my-index-000001
Request
editDELETE /<index>
Prerequisites
edit-
If the Elasticsearch security features are enabled, you must have the
delete_index
ormanage
index privilege for the target index.
Path parameters
edit-
<index>
-
(Request, string) Comma-separated list or wildcard expression of indices to delete.
In this parameter, wildcard expressions match only open, concrete indices. You cannot delete an index using an alias.
To delete all indices, use
_all
or*
. To disallow the deletion of indices with_all
or wildcard expressions, change theaction.destructive_requires_name
cluster setting totrue
. You can update this setting in theelasticsearch.yml
file or using the cluster update settings API.You cannot delete the current write index of a data stream. To delete the index, you must roll over the data stream so a new write index is created. You can then use the delete index API to delete the previous write index.
Query parameters
edit-
allow_no_indices
-
(Optional, Boolean) If
false
, the request returns an error if any wildcard expression, index alias, or_all
value targets only missing or closed indices. This behavior applies even if the request targets other open indices. For example, a request targetingfoo*,bar*
returns an error if an index starts withfoo
but no index starts withbar
.Defaults to
true
. -
expand_wildcards
-
(Optional, string) Type of index that wildcard expressions can match. If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams. Supports comma-separated values, such as
open,hidden
. Valid values are:-
all
- Match any data stream or index, including hidden ones.
-
open
- Match open, non-hidden indices. Also matches any non-hidden data stream.
-
closed
- Match closed, non-hidden indices. Also matches any non-hidden data stream. Data streams cannot be closed.
-
hidden
-
Match hidden data streams and hidden indices. Must be combined with
open
,closed
, or both. -
none
- Wildcard expressions are not accepted.
Defaults to
open
. -
-
ignore_unavailable
-
(Optional, Boolean) If
false
, the request returns an error if it targets a missing or closed index. Defaults tofalse
. -
master_timeout
-
(Optional, time units)
Period to wait for a connection to the master node. If no response is received
before the timeout expires, the request fails and returns an error. Defaults to
30s
. -
timeout
-
(Optional, time units)
Period to wait for a response. If no response is received before the timeout
expires, the request fails and returns an error. Defaults to
30s
.