delete-index.asciidoc 1.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354
  1. [[indices-delete-index]]
  2. === Delete index API
  3. ++++
  4. <titleabbrev>Delete index</titleabbrev>
  5. ++++
  6. Deletes an existing index.
  7. [source,js]
  8. --------------------------------------------------
  9. DELETE /twitter
  10. --------------------------------------------------
  11. // CONSOLE
  12. // TEST[setup:twitter]
  13. [[delete-index-api-request]]
  14. ==== {api-request-title}
  15. `DELETE /<index>`
  16. [[delete-index-api-path-params]]
  17. ==== {api-path-parms-title}
  18. `<index>`::
  19. +
  20. --
  21. (Request, string) Comma-separated list or wildcard expression of indices to
  22. delete.
  23. In this parameter, wildcard expressions match only open, concrete indices. You
  24. cannot delete an index using an <<indices-aliases,alias>>.
  25. To delete all indices, use `_all` or `*` . To disallow the deletion of indices
  26. with `_all` or wildcard expressions, change the
  27. `action.destructive_requires_name` cluster setting to `true`. You can update
  28. this setting in the `elasticsearch.yml` file or using the
  29. <<cluster-update-settings,cluster update settings>> API.
  30. --
  31. [[delete-index-api-query-params]]
  32. ==== {api-query-parms-title}
  33. include::{docdir}/rest-api/common-parms.asciidoc[tag=allow-no-indices]
  34. include::{docdir}/rest-api/common-parms.asciidoc[tag=expand-wildcards]
  35. +
  36. Defaults to `open`.
  37. include::{docdir}/rest-api/common-parms.asciidoc[tag=index-ignore-unavailable]
  38. include::{docdir}/rest-api/common-parms.asciidoc[tag=timeoutparms]