Skip to content

stratumctl snapshots

Manage volume snapshots

Terminal window
stratumctl snapshots [flags]

Aliases: snapshot, snap

Snapshot a volume (returns 202; poll until state=available)

Terminal window
stratumctl snapshots create <name> [flags]
Terminal window
stratumctl snapshots create data-before-upgrade --volume vol-3k8m2x7q9a
stratumctl snapshots create data-before-upgrade --volume vol-3k8m2x7q9a --description "before the 2.1 upgrade"
Flag Type Default Description
--description string Free-form description
--display-name string Human-friendly display name
--project string Project ID (defaults to STRATUM_PROJECT or profile project_id)
--quiesce bool false Reserved — guest-agent quiesce is wired
--volume string Source volume ID (required)

Delete a snapshot

Terminal window
stratumctl snapshots delete <snapshot-id> [flags]
Terminal window
stratumctl snapshots delete snap-4k8m2x7q9a
Flag Type Default Description
--project string Project ID (defaults to STRATUM_PROJECT or profile project_id)

Describe a snapshot

Terminal window
stratumctl snapshots get <snapshot-id> [flags]
Terminal window
stratumctl snapshots get snap-4k8m2x7q9a
stratumctl snapshots get snap-4k8m2x7q9a --output json
Flag Type Default Description
--project string Project ID (defaults to STRATUM_PROJECT or profile project_id)

List snapshots in a project

Terminal window
stratumctl snapshots list [flags]
Terminal window
stratumctl snapshots list
stratumctl snapshots list --source-volume vol-3k8m2x7q9a --output json
Flag Type Default Description
--project string Project ID (defaults to STRATUM_PROJECT or profile project_id)
--source-volume string Filter to snapshots of this volume

Restore a new volume from a snapshot

Terminal window
stratumctl snapshots restore <snapshot-id> [flags]
Terminal window
stratumctl snapshots restore snap-4k8m2x7q9a --name data-restored
stratumctl snapshots restore snap-4k8m2x7q9a --name data-restored --size-gib 200
Flag Type Default Description
--display-name string Human-friendly display name
--name string New volume name (required)
--project string Project ID (defaults to STRATUM_PROJECT or profile project_id)
--size-gib int64 0 Override size in GiB (must be >= snapshot size; defaults to snapshot size)