StorageSnapshots REST Endpoints

StorageSnapshots
Creating a snapshot of a storage volume enables you to capture all the data stored on the storage volume. You can retain snapshots as a backup, or use them to create new, identical storage volumes.

If you take multiple snapshots of a storage volume, each snapshot captures all the data stored on the storage volume. You can create either colocated or remote storage volume snapshots.

  • Colocated snapshots: Snapshots are stored in the same physical location as the original storage volume and each snapshot uses the same amount of storage as the original volume. Colocated snapshots and volumes from colocated snapshots can be created very quickly. Colocated snapshots are useful for quickly restoring storage volumes within a site. However, you can't restore volumes across sites using colocated snapshots.
  • Remote snapshots: Snapshots aren't stored in the same location as the original storage volume. Instead, they are reduced and stored in the associated Oracle Cloud Infrastructure Object Storage Classic instance. Remote snapshots are useful if your domain spans multiple sites. With remote snapshots, you can create a snapshot in one site, then switch to another site and create a copy of the storage volume on that site. However, creating a remote snapshot and restoring a storage volume from a remote snapshot can take quite a long time depending on the size of the storage volume, as data is written to and from the Oracle Cloud Infrastructure Object Storage Classic instance.

Create a Storage Volume Snapshot
Method: post
Path: /storage/snapshot/
Delete a Storage Volume Snapshot
Method: delete
Path: /storage/snapshot/{name}
Retrieve Details of a Storage Volume Snapshot
Method: get
Path: /storage/snapshot/{name}
Retrieve Details of all Storage Volume Snapshots in a Container
Method: get
Path: /storage/snapshot/{container}/
Retrieve Names of all Storage Volume Snapshots and Subcontainers in a Container
Method: get
Path: /storage/snapshot/{container}
Retrieve Names of Containers
Method: get
Path: /storage/snapshot/