DeleteIndex

Deletes an OpenSearch index. This operation permanently removes the index and cannot be undone.

Request Syntax


DELETE /2021-01-01/opensearch/domain/DomainName/index/IndexName HTTP/1.1

The request uses the following URI parameters.

The name of an OpenSearch Service domain. Domain names are unique across the domains owned by an account within an AWS Region.

Length Constraints: Minimum length of 3. Maximum length of 28.

Pattern: [a-z][a-z0-9\-]+

Required: Yes

The name of the index to delete.

Length Constraints: Minimum length of 1. Maximum length of 255.

Pattern: ^(?!\.\.?$)[^_ ,:"+/*\\|?#><A-Z-][^ ,:"+/*\\|?#><A-Z]*$

Required: Yes

The request does not have a request body.


HTTP/1.1 200
Content-type: application/json

{
   "Status": "string"
}

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

The status of the index deletion operation.

Type: String

Valid Values: CREATED | UPDATED | DELETED

For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

An error occurred because you don't have permissions to access the resource.

HTTP Status Code: 403

DependencyFailureException

An exception for when a failure in one of the dependencies results in the service being unable to fetch details about the resource.

HTTP Status Code: 424

DisabledOperationException

An error occured because the client wanted to access an unsupported operation.

HTTP Status Code: 409

InternalException

Request processing failed because of an unknown error, exception, or internal failure.

HTTP Status Code: 500

ResourceNotFoundException

An exception for accessing or deleting a resource that doesn't exist.

HTTP Status Code: 409

ThrottlingException

The request was denied due to request throttling. Reduce the frequency of your requests and try again.

HTTP Status Code: 429

ValidationException

An exception for accessing or deleting a resource that doesn't exist.

HTTP Status Code: 400