Skip to content
Postman API Testing Tips

How To Delete Index In Elasticsearch Using Postman

API Testing Blog

Deleting Indices in Elasticsearch Using Postman

Postman is a powerful tool for interacting with APIs, including Elasticsearch. Here’s a comprehensive guide on how to delete indices in Elasticsearch using Postman.

Understanding Indices

Indices are the fundamental organizational units in Elasticsearch. Each index holds data organized into documents. It’s crucial to understand that deleting an index is a permanent operation.

Prerequisites

  • Elasticsearch Instance: You need a running Elasticsearch instance accessible via a network.
  • Postman: Install the latest version of Postman on your computer.
  • Basic Elasticsearch Knowledge: Familiarity with Elasticsearch concepts like indices and document types is helpful.

Setting Up Your Postman Request

  1. Open a new Request: In Postman, click on the “New” button to create a new request.
  2. Select “POST” Method: Choose the “POST” method from the dropdown menu.
  3. Enter the Endpoint: The endpoint for deleting an index is http(s)://<Elasticsearch-host>:<port>/<index_name>/_delete. For example: http://localhost:9200/my-index/_delete.
  4. Authorization (Optional): If your Elasticsearch instance requires authentication, add your credentials under the “Authorization” tab in Postman.

Performing the Deletion

  1. Send the Request: Click the “Send” button.
  2. Response: You’ll receive a response from Elasticsearch. If the index was successfully deleted, you’ll see a status code 200 (OK).

Example Request using Postman

Let’s consider a scenario where you want to delete the index “my-index”.

Request:

URL: http://localhost:9200/my-index/_delete
Method: POST

Response:

{
  "acknowledged": true
}

Deleting Multiple Indices

You can delete multiple indices in one request. Simply list the index names separated by commas.

Request:

URL: http://localhost:9200/my-index,another-index/_delete
Method: POST

Handling Errors

If you try to delete an index that doesn’t exist, Elasticsearch will return a status code 404 (Not Found).

Example Response:

{
  "error": {
    "root_cause": [
      {
        "type": "index_not_found_exception",
        "reason": "no such index [non-existent-index]"
      }
    ],
    "type": "index_not_found_exception",
    "reason": "no such index [non-existent-index]",
    "index": "non-existent-index"
  },
  "status": 404
}

Deleting an Index with Specific Parameters

The API also allows you to include specific parameters in your request. For example, you can add the timeout parameter to control the maximum time to wait for the deletion operation.

Request:

URL: http://localhost:9200/my-index/_delete?timeout=10s
Method: POST

Tips and Best Practices

  • Use the _delete API: It’s recommended to use the dedicated _delete API for index deletion to ensure efficiency.
  • Check for Dependencies: Before deleting an index, make sure no other indices or applications depend on it.
  • Back Up Your Data: Always back up your Elasticsearch data before performing any potentially destructive operations.
  • Confirm Deletion: Double-check the index name to avoid accidentally deleting the wrong index.

By following these guidelines, you can safely and effectively delete indices in Elasticsearch using Postman. This control over your data is crucial for managing your Elasticsearch cluster and ensuring data integrity.

API Testing Blog