48 lines
1.3 KiB
Markdown
48 lines
1.3 KiB
Markdown
---
|
|
layout: default
|
|
title: Delete Snapshot
|
|
parent: Snapshot APIs
|
|
nav_order: 7
|
|
---
|
|
|
|
## Delete snapshot
|
|
**Introduced 1.0**
|
|
{: .label .label-purple }
|
|
|
|
Deletes a snapshot from a repository.
|
|
|
|
* To learn more about snapshots, see [Snapshots]({{site.url}}{{site.baseurl}}/opensearch/snapshots/index).
|
|
|
|
* To view a list of your repositories, see [cat repositories]({{site.url}}{{site.baseurl}}/api-reference/cat/cat-repositories).
|
|
|
|
* To view a list of your snapshots, see [cat snapshots]({{site.url}}{{site.baseurl}}/api-reference/cat/cat-snapshots).
|
|
|
|
## Path parameters
|
|
|
|
Parameter | Data type | Description
|
|
:--- | :--- | :---
|
|
repository | String | Repostory that contains the snapshot. |
|
|
snapshot | String | Snapshot to delete. |
|
|
|
|
#### Example request
|
|
|
|
The following request deletes a snapshot called `my-first-snapshot` from the `my-opensearch-repo` repository:
|
|
|
|
```json
|
|
DELETE _snapshot/my-opensearch-repo/my-first-snapshot
|
|
```
|
|
{% include copy-curl.html %}
|
|
|
|
#### Example response
|
|
|
|
Upon success, the response returns the following JSON object:
|
|
|
|
```json
|
|
{
|
|
"acknowledged": true
|
|
}
|
|
```
|
|
|
|
To verify that the snapshot was deleted, use the [Get snapshot]({{site.url}}{{site.baseurl}}/api-reference/snapshots/get-snapshot) API, passing the snapshot name as the `snapshot` path parameter.
|
|
{: .note}
|