OpenSearch/docs/reference/indices/delete-index.asciidoc

[[indices-delete-index]]
=== Delete Index

The delete index API allows to delete an existing index.

[source,js]
--------------------------------------------------
DELETE /twitter
--------------------------------------------------
// CONSOLE
// TEST[setup:twitter]

The above example deletes an index called `twitter`. Specifying an index or a
wildcard expression is required. Aliases cannot be used to delete an index.
Wildcard expressions are resolved to matching concrete indices only.

The delete index API can also be applied to more than one index, by either
using a comma separated list, or on all indices (be careful!) by using `_all` or `*` as index.

In order to disable allowing to delete indices via wildcards or `_all`,
set `action.destructive_requires_name` setting in the config to `true`.
This setting can also be changed via the cluster update settings api.
Migrated documentation into the main repo 2013-08-28 19:24:34 -04:00			`[[indices-delete-index]]`
[DOCS] Remove heading offsets for REST APIs (#44568) Several files in the REST APIs nav section are included using :leveloffset: tags. This increments headings (h2 -> h3, h3 -> h4, etc.) in those files and removes the :leveloffset: tags. Other supporting changes: * Alphabetizes top-level REST API nav items. * Change 'indices APIs' heading to 'index APIs.' * Changes 'Snapshot lifecycle management' heading to sentence case. 2019-07-19 14:35:36 -04:00			`=== Delete Index`
Migrated documentation into the main repo 2013-08-28 19:24:34 -04:00
			`The delete index API allows to delete an existing index.`

			`[source,js]`
			`--------------------------------------------------`
Add CONSOLE to a few snippets in reference docs This allows them to be run in Console and adds them to the list of docs that are automatically tested as part of the build. Relates to #18160 2016-09-01 13:05:22 -04:00			`DELETE /twitter`
Migrated documentation into the main repo 2013-08-28 19:24:34 -04:00			`--------------------------------------------------`
Add CONSOLE to a few snippets in reference docs This allows them to be run in Console and adds them to the list of docs that are automatically tested as part of the build. Relates to #18160 2016-09-01 13:05:22 -04:00			`// CONSOLE`
			`// TEST[setup:twitter]`
Migrated documentation into the main repo 2013-08-28 19:24:34 -04:00
[DOCS] delete index no longer supports specifying aliases 2017-06-19 04:30:05 -04:00			The above example deletes an index called `twitter`. Specifying an index or a
			`wildcard expression is required. Aliases cannot be used to delete an index.`
			`Wildcard expressions are resolved to matching concrete indices only.`
Migrated documentation into the main repo 2013-08-28 19:24:34 -04:00
[DOCS] delete index no longer supports specifying aliases 2017-06-19 04:30:05 -04:00			`The delete index API can also be applied to more than one index, by either`
			using a comma separated list, or on all indices (be careful!) by using `_all` or `*` as index.
Added `action.destructive_requires_name` that controls whether wildcard expressions and `_all` is allowed to be used for destructive operat Also the delete index api requires always an index to be specified (either concrete index, alias or wildcard expression) Closes #4549 #4481 2014-01-04 12:54:17 -05:00
			In order to disable allowing to delete indices via wildcards or `_all`,
			set `action.destructive_requires_name` setting in the config to `true`.
Merge pull request #15856 from marcbachmann/patch-1 Document index deletion using comma separated indices 2016-01-10 04:47:44 -05:00			`This setting can also be changed via the cluster update settings api.`