Skip to main content
Element Software
Une version plus récente de ce produit est disponible.
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

RollbackToSnapshot

Contributeurs
PDF

Vous pouvez utiliser la RollbackToSnapshot méthode pour créer un instantané existant de l'image de volume active. Cette méthode crée un nouvel instantané à partir d'un instantané existant.

Le nouveau snapshot est activé et le snapshot existant est conservé jusqu'à sa suppression manuelle. Le snapshot précédemment actif est supprimé, sauf si vous définissez le paramètre saveCurrentState sur true.

CLUSTER_PLÉNITUDE

Remarque

  • Vous pouvez créer des instantanés si la plénitude de cluster est aux étapes 1, 2 ou 3. Vous ne pouvez pas créer de snapshots lorsque la plénitude de cluster atteint l'étape 4 ou 5.

  • La restauration d'un volume vers un snapshot peut échouer lorsque la synchronisation des coupes est en cours. Réessayez RollbackToSnapshot une fois la synchronisation terminée.

Paramètres

Cette méthode présente les paramètres d'entrée suivants :

Nom Description Type Valeur par défaut Obligatoire

ID de volume

VolumeID du volume.

entier

Aucune

Oui

attributs

Liste des paires nom-valeur au format d'objet JSON.

Attributs des JSON

Aucune

Non

nom

Nom du snapshot. Si aucun nom n'est donné, le nom du snapshot restauré à est utilisé avec la mention « - copie » ajouté à la fin du nom.

chaîne

Aucune

Non

ID de snapshot

ID d'un snapshot précédemment créé sur le volume donné.

entier

Aucune

Oui

SaveCurrentState

Indique s'il faut enregistrer ou non l'image de volume active précédente. Valeurs valides :

  • True : l'image de volume active précédente est conservée.

  • FALSE : l'image de volume active précédente est supprimée.

booléen

faux

Non

Valeurs de retour

Cette méthode a les valeurs de retour suivantes :

Nom

Description

Type

somme de contrôle

Une petite représentation des données dans le snapshot stocké.

chaîne

ID de snapshot

Si saveCurrentState a été défini sur FALSE, cette valeur est nulle.

Si saveCurrentState a été défini sur true, l'ID unique du snapshot nouvellement créé.

entier

snapshot

Si saveCurrentState a été défini sur FALSE, cette valeur est nulle.

Si saveCurrentState a été défini sur true, un objet contenant des informations sur le nouvel instantané créé.

snapshot

Exemple de demande

Les demandes pour cette méthode sont similaires à l'exemple suivant :

{
 "method": "RollbackToSnapshot",
 "params": {
    "volumeID": 1,
    "snapshotID": 3114,
    "saveCurrentState": true
  },
  "id": 1
}

Exemple de réponse

Cette méthode renvoie une réponse similaire à l'exemple suivant :

{
  "id": 1,
  "result": {
    "checksum": "0x0",
    "snapshot": {
      "attributes": {},
      "checksum": "0x0",
      "createTime": "2016-04-04T17:27:32Z",
      "enableRemoteReplication": false,
      "expirationReason": "None",
      "expirationTime": null,
      "groupID": 0,
      "groupSnapshotUUID": "00000000-0000-0000-0000-000000000000",
      "name": "test1-copy",
      "snapshotID": 1,
      "snapshotUUID": "30d7e3fe-0570-4d94-a8d5-3cc8097a6bfb",
      "status": "done",
      "totalSize": 5000658944,
      "virtualVolumeID": null,
      "volumeID": 1
    },
    "snapshotID": 1
  }
}

Nouveau depuis la version

9,6