opensearch-docs-cn/_opensearch/rest-api/snapshots/delete-snapshot-repository.md

1.3 KiB

layout title parent grand_parent nav_order
default Delete Snapshot Repository Snapshot APIs REST API reference 3

Delete snapshot repository configuration.

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 parameters

Parameter Data Type Description
repository String Repository to delete.

Sample request

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

DELETE _snapshot/my-opensearch-repo

Sample 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. {: .note}