You're viewing version 2.17 of the OpenSearch documentation. This version is no longer maintained. For the latest version, see the current documentation. For information about OpenSearch version maintenance, see Release Schedule and Maintenance Policy.

Delete snapshot repository configuration

Introduced 1.0

Deletes a snapshot repository configuration.

A repository in OpenSearch is simply a configuration that maps a repository name to a type (file system or s3 repository) along with other information depending on the type. The configuration is backed by a file system location or an s3 bucket. When you invoke the API, the physical file system or s3 bucket itself is not deleted. Only the configuration is deleted.

To learn more about repositories, see Register or update snapshot repository.

Path and HTTP methods

DELETE _snapshot/<repository>

Path parameters

Example request

The following request deletes the my-opensearch-repo repository:

DELETE _snapshot/my-opensearch-repo

Example response

Upon success, the response returns the following JSON object:

{
  "acknowledged" : true
}

To verify that the repository was deleted, use the Get snapshot repository API, passing the repository name as the repository path parameter.