> For the complete documentation index, see [llms.txt](https://docs.acecloud.ai/knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.acecloud.ai/knowledge-base/cli/storage/snapshots.md).

# 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                            |