DocsAbout storageVolume snapshots

Volume snapshots

Create, restore, edit and schedule snapshots of custom storage volumes.

A volume snapshot is a point-in-time copy of a custom volume. Snapshots let you roll a volume back to an earlier state, for example before an upgrade or a risky data migration. For snapshots of whole instances, see Instance snapshots.

Snapshot creation can be blocked by project policy (restricted.snapshots). If the snapshot buttons are disabled in your project, ask your administrator.

Create a snapshot

  1. Go to StorageVolumes and open the volume.
  2. Go to the Snapshots tab and click Create snapshot.
  3. Optionally set a name and an expiry date and time. If you leave the name empty, the volume's snapshot name pattern applies. If you set an expiry, the snapshot is deleted automatically once it passes.
  4. Click Create.

Restore a snapshot

Restoring overwrites the volume's current contents with the snapshot's contents.

  1. On the volume's Snapshots tab, find the snapshot.
  2. Click Restore and confirm. This action cannot be undone and can result in data loss — data written after the snapshot is discarded.

Edit a snapshot

Use the Edit action on a snapshot to rename it or change its expiry date.

Delete snapshots

Delete a single snapshot with its Delete action, or select multiple snapshots in the table and use bulk delete. The table supports search and pagination, so you can clean up old snapshots in batches.

Scheduled snapshots

You can snapshot a volume automatically on a schedule. On the volume's Snapshots tab, click See configuration and set:

SettingKeyNotes
Snapshot name patternsnapshots.patternTemplate used to name automatic (and unnamed manual) snapshots.
Expire aftersnapshots.expiryHow long each automatic snapshot is kept, for example 7d.
Schedulesnapshots.scheduleCron expression (<minute> <hour> <day-of-month> <month> <day-of-week>).

For example, 0 3 * * * snapshots the volume every day at 03:00. Combine a schedule with an expiry so old snapshots are pruned automatically.