Créer un snapshot d’un volume

Vous pouvez créer un snapshot d’un volume afin de faire une image à un moment donné des données stockées sur celui-ci. Vous pouvez alors créer un nouveau volume à partir de ce snapshot, copier ce snapshot dans une autre Région ou le partager avec d’autres comptes.

En cas d’usage excessif de la fonctionnalité de création de snapshots pour un même volume sur une courte période, 3DS OUTSCALE se réserve le droit de bloquer temporairement la fonctionnalité.

Créer un snapshot d’un volume avec Cockpit v2

Vous pouvez également effectuer cette action dans le dashboard Volumes, en sélectionnant un volume et en cliquant sur IconAddFull Créer un snapshot dans le menu d’action qui apparaît.

Dans le dashboard Snapshots, cliquez sur Créer un snapshot.
La boîte de dialogue CRÉER UN SNAPSHOT apparaît.
Dans le champ Nom, tapez un nom pour le snapshot.

Cette action ajoute un tag Name de 255 caractères maximum. Vous pouvez utiliser tous les caractères, y compris les lettres accentuées.
(optionnel) Dans le champ Description, tapez une description du snapshot.
Dans la liste Volume, sélectionnez le volume dont vous voulez créer un snapshot.

Si des données sont en cours d’écriture sur le volume au moment où vous créez le snapshot, celui-ci peut être incomplet.
Cliquez sur Créer un snapshot.
Le snapshot est créé.

Créer un snapshot d’un volume avec OSC CLI

À ce jour, cette section est disponible en anglais uniquement.

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 a bucket by using the CreateSnapshotExportTask method. Then, they must grant you permission to read the snapshot via a pre-signed URL. For more information, see Creating a Pre-Signed URL.

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.
- RequestId: The ID of the request.
Snapshot: Information about the snapshot.
- AccountAlias: The account alias of the owner of the snapshot.
- AccountId: The account ID of the owner of the snapshot.
- ClientToken: The idempotency token provided when creating the snapshot.
- CreationDate: The date and time (UTC) at which the snapshot was created.
- Description: The description of the snapshot.
- PermissionsToCreateVolume: Permissions for the resource.
  - AccountIds: One or more account IDs that the permission is associated with.
  - GlobalPermission: A global permission for all accounts.
    (Request) Set this parameter to true to make the resource public (if the parent parameter is Additions) or to make the resource private (if the parent parameter is Removals).
    (Response) If true, the resource is public. If false, the resource is private.
- Progress: The progress of the snapshot, as a percentage.
- SnapshotId: The ID of the snapshot.
- State: The state of the snapshot (in-queue | pending | completed | error | deleting)).
- Tags: One or more tags associated with the snapshot.
  - Key: The key of the tag, with a minimum of 1 character.
  - Value: The value of the tag, between 0 and 255 characters.
- VolumeId: The ID of the volume used to create the snapshot.
- VolumeSize: The size of the volume used to create the snapshot, in gibibytes (GiB).

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"
  }
}

Créer un snapshot d’un volume avec oapi-cli

À ce jour, cette section est disponible en anglais uniquement.

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 a bucket by using the CreateSnapshotExportTask method. Then, they must grant you permission to read the snapshot via a pre-signed URL. For more information, see Creating a Pre-Signed URL.

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

$ oapi-cli --profile "default" CreateSnapshot \
    --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.
- RequestId: The ID of the request.
Snapshot: Information about the snapshot.
- AccountAlias: The account alias of the owner of the snapshot.
- AccountId: The account ID of the owner of the snapshot.
- ClientToken: The idempotency token provided when creating the snapshot.
- CreationDate: The date and time (UTC) at which the snapshot was created.
- Description: The description of the snapshot.
- PermissionsToCreateVolume: Permissions for the resource.
  - AccountIds: One or more account IDs that the permission is associated with.
  - GlobalPermission: A global permission for all accounts.
    (Request) Set this parameter to true to make the resource public (if the parent parameter is Additions) or to make the resource private (if the parent parameter is Removals).
    (Response) If true, the resource is public. If false, the resource is private.
- Progress: The progress of the snapshot, as a percentage.
- SnapshotId: The ID of the snapshot.
- State: The state of the snapshot (in-queue | pending | completed | error | deleting)).
- Tags: One or more tags associated with the snapshot.
  - Key: The key of the tag, with a minimum of 1 character.
  - Value: The value of the tag, between 0 and 255 characters.
- VolumeId: The ID of the volume used to create the snapshot.
- VolumeSize: The size of the volume used to create the snapshot, in gibibytes (GiB).

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"
  }
}

Créer un snapshot d’un volume avec AWS CLI

Avant de commencer : Installez et configurez AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.

Pour créer un snapshot d’un volume spécifique, utilisez la commande create-snapshot en suivant cette syntaxe :

Exemple de requête

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

Cette commande contient les options suivantes que vous devez spécifier :

(optionnel) profile : Le profil nommé que vous voulez utiliser, créé pendant la configuration d’AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.
volume-id : L’ID du volume dont vous souhaitez créer un snapshot.
(optionnel) description : Une description du snapshot.
endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête. Pour en savoir plus, voir Installer et configurer AWS CLI.

La commande create-snapshot renvoie les éléments suivants :

Description : Une description du snapshot, si fournie dans la requête.
OwnerId : L’ID du compte propriétaire du snapshot.
Progress : La progression du snapshot (en pourcentage).
SnapshotId : L’ID du nouveau snapshot créé.
State : L’état du snapshot (in-queue | pending | completed).
StartTime : L’heure à laquelle le snapshot a été démarré.
VolumeId : L’ID du volume utilisé pour créer le snapshot.
VolumeSize : La taille du volume, en gibioctets (Gio).

Exemple de résultat

{
    "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
}

Un snapshot du volume spécifié est créé.

Pages connexes

Méthodes API correspondantes

AWS™ et Amazon Web Services™ sont des marques de commerce d'Amazon Technologies, Inc. ou de ses affiliées aux États-Unis et/ou dans les autres pays.