Delete index alias APIedit

Deletes an existing index alias.

An index alias is a secondary name for one or more indices. Most Elasticsearch APIs accept an index alias in place of an index name.

DELETE /my-index-000001/_alias/alias1

Requestedit

DELETE /<index>/_alias/<alias>

DELETE /<index>/_aliases/<alias>

Prerequisitesedit

  • If the Elasticsearch security features are enabled, you must have the manage index privilege for both the index and index alias.

Path parametersedit

<index>

(Required, string) Comma-separated list or wildcard expression of index names used to limit the request.

To include all indices in the cluster, use a value of _all or *.

<alias>

(Required, string) Comma-separated list or wildcard expression of index alias names used to limit the request.

To delete all aliases, use a value of _all or *.

Query parametersedit

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.