--- title: "Enterprise File Storage - Restaurer un volume à l'aide de l'API de restauration de snapshots" description: "Découvrez comment restaurer les volumes de votre solution Enterprise File Storage grâce à la fonctionnalité de restauration de snapshots fournie par l'API OVHcloud" url: https://docs.ovhcloud.com/fr/guides/storage-and-backup/file-storage/enterprise-file-storage/netapp-revert-snapshot lang: fr lastUpdated: 2023-09-15 --- # Enterprise File Storage - Restaurer un volume à l'aide de l'API de restauration de snapshots ## Objectif Dans ce guide, nous allons expliquer comment restaurer un volume à son dernier snapshot, à l'aide de la fonction de _snapshot revert_. **Apprenez à restaurer les volumes de votre solution Enterprise File Storage à l'aide de la fonctionnalité de restauration de snapshots via l'API OVHcloud.** ## Prérequis - Disposer d'une offre OVHcloud Enterprise File Storage avec un volume - Être connecté à l’[API OVHcloud](https://eu.api.ovh.com/) ## Principes de base Un snapshot (ou instantané) d'un volume est une copie ponctuelle en lecture seule d'un volume. Les snapshots sont crées à partir d'un volume existant et opérationnel. Un snapshot ne peut pas être utilisé si le volume auquel il appartient n'existe plus. :::warning Veuillez noter qu'une fois qu'un volume est restauré à l'aide d'un snapshot, tous les fichiers ou snapshots créés ultérieurement seront perdus. Lorsqu'un volume est restauré, toutes les données qu'il contient sont remplacées par les données du snapshot. Cette action est irréversible. ::: Dans ce guide, un volume est également appelé « _share_ » comme dans l’API OVHcloud. ## Limites Il est uniquement possible de restaurer un volume à son snapshot le plus récent disponible. Toutefois, si vous souhaitez restaurer un volume à partir d'un snapshot antérieur, vous devez supprimer les snapshots jusqu'à ce que le snapshot à utiliser pour la restauration soit le plus récent. ## En pratique ### Scénario 1 : restaurer un volume depuis un snapshot de type `manual` Dans ce scénario, vous souhaitez restaurer votre volume à son dernier snapshot de type `manual`, créé via l'API OVHcloud ou l'espace client OVHcloud. :::info **Prérequis pour ce scénario :** - Vous avez déjà creé un snapshot de type `manual`. Dans le cas contraire, vous pouvez créer un snapshot de type `manual` via l’API OVHcloud ou votre espace client OVHcloud. - Le snapshot de type `manual` doit appartenir au volume que vous souhaitez restaurer. ::: 1\. Identifiez le dernier snapshot de type `manual` à l'aide de l'appel API suivant : 🇪🇺EU▾ [GET/storage/netapp/{serviceName}/share/{shareId}/snapshot](https://eu.api.ovh.com/console/?section=/storage&branch=v1#get-/storage/netapp/-serviceName-/share/-shareId-/snapshot) - `{serviceName}` est l'identifiant unique du service - `{shareId}` est le volume à restaurer ![RevertManualSnapshot](/images/storage-and-backup/file-storage/enterprise-file-storage/netapp-revert-snapshot/use_case_1_step_1.png) 2\. Restaurez votre volume à son dernier snapshot en utilisant l'appel API `/revert` : 🇪🇺EU▾ [POST/storage/netapp/{serviceName}/share/{shareId}/revert](https://eu.api.ovh.com/console/?section=/storage&branch=v1#post-/storage/netapp/-serviceName-/share/-shareId-/revert) - `{serviceName}` est l'identifiant unique du service - `{shareId}` est le volume à restaurer - `{snapshotID}` est le dernier snapshot du volume L’API OVHcloud retournera uniquement un code HTTP 202 (_Accepted_ ). L'état du volume passera à `reverting` , puis reviendra à `available` une fois le processus de restauration du volume terminé. De manière simultanée, l'état du snapshot passera à `restoring` puis reviendra à `available` une fois le processus de restauration du volume terminé. ![RevertManualSnapshot](/images/storage-and-backup/file-storage/enterprise-file-storage/netapp-revert-snapshot/use_case_1_step_2.png) ### Scénario 2 : Restaurer un volume depuis un snapshot effectué via la Snapshot policy Dans ce scénario, une règle d'une politique de snapshots (_Snapshot policy_) prend des snapshots réguliers (automatiques) d'un volume et vous souhaitez restaurer votre volume au dernier snapshot crée par la _Snapshot policy_. Vous devrez « conserver » (`hold`) le dernier snapshot pris par la Snapshot policy associée à un volume afin que ce snapshot devienne un snapshot `manual`. Une fois que le snapshot est de type `manual`, son volume associé peut y être restauré. :::info **Prérequis pour ce scénario :** - Vous avez créé une _snapshot policy_ et vous l'avez associée au volume à restaurer. - Cette _snapshot policy_ a créé au moins un snapshot. ::: :::info Les snapshots pris par la _snapshot policy_ sont de type `automatic`. Pour qu'ils puissent être utilisés pour la restauration de volume, ils doivent être conservés en utilisant la route API `/hold`. Cela empêchera leur rotation par la _Snapshot policy_. ::: 1\. Identifiez le dernier snapshot de type `automatic` à l'aide de l'appel API suivant : 🇪🇺EU▾ [GET/storage/netapp/{serviceName}/share/{shareId}/snapshot](https://eu.api.ovh.com/console/?section=/storage&branch=v1#get-/storage/netapp/-serviceName-/share/-shareId-/snapshot) - `{serviceName}` est l'identifiant unique du service - `{shareId}` est le volume à restaurer ![RevertSnapshot](/images/storage-and-backup/file-storage/enterprise-file-storage/netapp-revert-snapshot/use_case_2_step_1.png) 2\. Conservez le Snapshot en utilisant l'appel API suivant : 🇪🇺EU▾ [POST/storage/netapp/{serviceName}/share/{shareId}/snapshot/{snapshotId}/hold](https://eu.api.ovh.com/console/?section=/storage&branch=v1#post-/storage/netapp/-serviceName-/share/-shareId-/snapshot/-snapshotId-/hold) - `{serviceName}` est l'identifiant unique du service - `{shareId}` est le volume à restaurer - `{snapshotID}` est le dernier snapshot automatique en date :::warning Une fois l'opération de conservation (`hold`) effectuée, l'identifiant et le type du snapshot seront modifiés. Toutefois, ses propriétés `name`, `createdAt` et `path` seront conservées. Veuillez prendre note du nouvel `id` pour les étapes suivantes. ::: ![RevertSnapshot](/images/storage-and-backup/file-storage/enterprise-file-storage/netapp-revert-snapshot/use_case_2_step_2.png) 3\. Assurez-vous que le nouveau snapshot est le dernier snapshot de type `manual` du volume. Si d'autres snapshots de type `manual` ont été pris avant ce snapshot, ils devront être supprimés. 4\. La route API utilisée pour récupérer la liste des snapshots du volume de l'étape 1 peut être réutilisée ici. ![RevertSnapshot](/images/storage-and-backup/file-storage/enterprise-file-storage/netapp-revert-snapshot/use_case_2_step_3.png) 5\. Restaurez le volume à son dernier snapshot en appelant la route API `/revert` : 🇪🇺EU▾ [POST/storage/netapp/{serviceName}/share/{shareId}/revert](https://eu.api.ovh.com/console/?section=/storage&branch=v1#post-/storage/netapp/-serviceName-/share/-shareId-/revert) - `{serviceName}` est l'identifiant unique du service - `{shareId}` est la volume à restaurer - `{snapshotID}` est le dernier snapshot en date du volume L’API OVHcloud retournera uniquement un code HTTP 202 (_Accepted_ ). L'état du volume passera à `reverting` , puis reviendra à `available` une fois le processus de restauration du volume terminé. De manière simultanée, l'état du snapshot passera à `restoring` puis reviendra à `available` une fois le processus de restauration du volume terminé. ![RevertSnapshot](/images/storage-and-backup/file-storage/enterprise-file-storage/netapp-revert-snapshot/use_case_2_step_4.png) Le volume est maintenant restauré au snapshot sélectionné. ## Aller plus loin Si vous avez besoin d'une formation ou d'une assistance technique pour la mise en oeuvre de nos solutions, contactez votre commercial ou cliquez sur [ce lien](https://www.ovhcloud.com/fr/professional-services/) pour obtenir un devis et demander une analyse personnalisée de votre projet à nos experts de l’équipe Professional Services. Échangez avec notre [communauté d’utilisateurs](https://community.ovhcloud.com/).