# Snapshots

Volume snapshots are point-in-time copies of block storage volumes. They can be used for backup and recovery purposes.

***

## List

List all volume snapshots in the current project.

```bash
ace snapshot list
```

**Aliases:** `ls`

**Example output:**

```
ID                                     NAME                      STATUS       SIZE       VOLUME ID                              CREATED
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx   snap-my-data-2025-03-20   available    50 GB      yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy   2025-03-20
zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz   snap-boot-vol-backup      available    100 GB     aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa   2025-03-18
```

**JSON output:**

```bash
ace snapshot list -o json
```

***

## Snapshot Fields

| Field       | Description                                            |
| ----------- | ------------------------------------------------------ |
| `ID`        | Unique snapshot identifier                             |
| `Name`      | Snapshot name                                          |
| `Status`    | Current status (e.g. `available`, `creating`, `error`) |
| `Size`      | Size of the snapshot in GB                             |
| `Volume ID` | Source volume UUID                                     |
| `Created`   | Creation date                                          |

***

## Get Snapshot Details

Look up a single snapshot by ID or name.

```bash
ace snapshot get <snapshot-id|name>
```

**Aliases:** `show`

### Example

```bash
ace snapshot get snap-my-data-2026-05-18
```

### Sample Output

```
  ID:              xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
  Name:            snap-my-data-2026-05-18
  Status:          available
  Size:            50 GB
  Volume ID:       yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy
  Volume Name:     my-data
  Description:     pre-upgrade backup
  Created:         2026-05-18T10:30:00Z
```

```bash
# JSON output
ace snapshot get snap-my-data-2026-05-18 -o json
```

***

## Delete Snapshots

Delete one or more snapshots by ID or name.

```bash
ace snapshot delete <snapshot-id|name> [...]
```

**Aliases:** `rm`

### Examples

```bash
# Delete a single snapshot
ace snapshot delete snap-old-backup

# Delete multiple snapshots
ace snapshot delete snap-1 snap-2 snap-3

# Skip confirmation prompt
ace snapshot delete snap-old-backup --yes
```

### Sample Output

```
Deleted 2 snapshot(s).
```

Deletion is permanent. You cannot recover a deleted snapshot. To restore from a snapshot before deletion, create a new volume from it (`ace volume create --from-snapshot <id>`).

***

## Note

* Snapshots can also be created from the AceCloud web portal or via `ace volume snapshot <volume-id>` (see the [Volumes](/knowledge-base/cli/storage/volumes.md) page).

***

## Global Flags

| Flag           | Description                                |
| -------------- | ------------------------------------------ |
| `-o, --output` | Output format: `table` (default) or `json` |
| `--project`    | Override project ID                        |
| `--region`     | Override region                            |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.acecloud.ai/knowledge-base/cli/storage/snapshots.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.