Creating a Snapshot of a Volume

You can create a snapshot of a volume to make a point-in-time image of the data stored on this volume. You can then create a new volume based on this snapshot, copy it to another Region or share it with other accounts.

In case of excessive use of the snapshot creation feature on the same volume over a short period of time, 3DS OUTSCALE reserves the right to temporarily block the feature.

Creating a Snapshot of a Volume Using Cockpit v2

You can also do this action in the Volumes dashboard, by selecting a volume and clicking IconAddFull Create Snapshot in the displayed menu.

  1. In the Snapshots dashboard, click IconAddFull Create Snapshot.
    The CREATE SNAPSHOT dialog box appears.

  2. In the Name field, type a name for the snapshot.

    This action adds a Name tag of 255 characters maximum. You can use any character, including accented letters.

  3. (optional) In the Description field, type a description of the snapshot.

  4. From the Volume list, select the volume of which you want to create a snapshot.

    If data is being written on the volume at the time you create the snapshot, this snapshot may be incomplete.

  5. Click Create Snapshot.
    The snapshot is created.

Creating a Snapshot of a Volume Using OSC CLI

The CreateSnapshot command creates a snapshot. Snapshots are point-in-time images of a volume that you can use to back up your data or to create replicas of this volume.
You can use this method in three different ways:

  • Creating from a volume: You create a snapshot from one of your volumes.

  • Copying a snapshot: You copy an existing snapshot. The source snapshot can be one of your own snapshots, or a snapshot owned by another account that has granted you permission via the UpdateSnapshot method.

  • Importing from a bucket: You import a snapshot located in an OUTSCALE Object Storage (OOS) bucket. First, the owner of the source snapshot must export it to the bucket by using the CreateSnapshotExportTask method. Then, they must grant you permission to read the snapshot via a pre-signed URL or Access Control Lists. For more information, see [Managing Access to Your Buckets and Objects].

In case of excessive use of the snapshot creation feature on the same volume over a short period of time, 3DS OUTSCALE reserves the right to temporarily block the feature.

For more information, see About Snapshots.
Request sample: Creating from a volume
$ osc-cli api CreateSnapshot --profile "default" \
    --VolumeId "vol-12345678" \
    --Description "Snapshot created from a volume"

This command contains the following attributes that you need to specify:

  • Description: (optional) A description for the snapshot.

  • DryRun: (optional) If true, checks whether you have the required permissions to perform the action.

  • VolumeId: (optional) (when creating from a volume) The ID of the volume you want to create a snapshot of.

The CreateSnapshot command returns the following elements:

  • ResponseContext: Information about the context of the response.

  • Snapshot: Information about the snapshot.

Result sample: Creating from a volume
{
  "Snapshot": {
    "VolumeSize": 10,
    "AccountId": "123456789012",
    "VolumeId": "vol-12345678",
    "CreationDate": "2010-10-01T12:34:56.789Z",
    "PermissionsToCreateVolume": {
      "GlobalPermission": false,
      "AccountIds": []
    },
    "Progress": 0,
    "SnapshotId": "snap-12345678",
    "State": "pending/queued",
    "Description": "Snapshot created from a volume",
    "Tags": []
  },
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  }
}

Creating a Snapshot of a Volume Using AWS CLI

To create a snapshot of a specified volume, use create-snapshot command following this syntax:

Request sample
$ aws ec2 create-snapshot \
    --profile YOUR_PROFILE \
    --volume-id vol-12345678 \
    --description snapshot of vol-12345678 \
    --endpoint https://fcu.eu-west-2.outscale.com

This command contains the following attributes that you need to specify:

  • (optional) profile: The named profile you want to use, created when configuring AWS CLI. For more information, see Installing and Configuring AWS CLI.

  • volume-id: The ID of the volume you want to create a snapshot of.

  • (optional) description: A description of the snapshot.

  • endpoint: The endpoint corresponding to the Region you want to send the request to.

The create-snapshot command returns the following elements:

  • Description: A description of the snapshot, if provided in the request.

  • OwnerId: The account ID of the owner of the snapshot.

  • Progress: The progress of the snapshot (a percentage).

  • SnapshotId: The ID of the newly created snapshot.

  • State: The state of the snapshot (in-queue | pending | completed).

  • StartTime: The time at which the snapshot was initiated.

  • VolumeId: The ID of the volume used to create the snapshot.

  • VolumeSize: The size of the volume, in gibibytes (GiB).

Result sample
{
    "Description": "snapshot of vol-12345678",
    "Progress": "0%",
    "OwnerId": "123456789012",
    "SnapshotId": "snap-87654321",
    "StartTime": "2018-03-26T13:01:33.176Z",
    "State": "pending",
    "VolumeId": "vol-12345678",
    "VolumeSize": 50
}

A snapshot of the specified volume is created.

Related Pages

Corresponding API Methods

AWS™ and Amazon Web Services™ are trademarks of Amazon Technologies, Inc or its affiliates in the United States and/or other countries.

Export to PDF