--- title: "NAS-HA - Gestion des snapshots via API" description: "Apprenez à gérer les snapshots du NAS-HA via l'API OVHcloud" url: https://docs.ovhcloud.com/fr/guides/storage-and-backup/file-storage/ha-nas/nas-snapshots-api lang: fr lastUpdated: 2022-07-20 --- # NAS-HA - Gestion des snapshots via API ## Objectif Les NAS-HA OVHcloud vous permettent de créer et de gérer des volumes de fichiers accessibles depuis un réseau. **Ce guide vous explique comment gérer les snapshots d'une partition NAS-HA via l'API OVHcloud.** ## Prérequis - Un service [NAS-HA OVHcloud](https://www.ovhcloud.com/fr/storage-solutions/nas-ha/) - Consultez notre guide des [premiers pas avec l'API OVHcloud](/fr/guides/manage-and-operate/api/first-steps.md) afin de vous familiariser avec l'APIv6 OVHcloud ## En pratique :::info N’hésitez pas à vous rendre sur [la page FAQ NAS-HA](/fr/guides/storage-and-backup/file-storage/ha-nas/nas-faq.md) pour retrouver toutes les informations détaillées concernant la fonction snapshot. ::: Toutes les routes API de ce guide sont disponibles dans la section _/dedicated/nasha_ : [https://api.ovh.com/console/#/dedicated/nasha](https://api.ovh.com/console/#/dedicated/nasha). :::info Lors de l'utilisation de l'API, tous les champs marqués d'un astérisque (\*) sont obligatoires. ::: ### Récupérer des informations sur votre service Tous vos services actifs peuvent être récupérés en utilisant la route suivante : 🇪🇺EU▾ [GET/dedicated/nasha](https://eu.api.ovh.com/console/?section=/dedicated/nasha&branch=v1#get-/dedicated/nasha) Par défaut, un snapshot de vos données a lieu toutes les heures et est sauvegardé sur votre NAS-HA. Vous pouvez activer d'autres stratégies de snapshot qui créeront des snapshots à des fréquences prédéfinies. ### Récupérer la planification automatique des snapshots Pour afficher la planification de snapshot automatique active, utilisez la route suivante : 🇪🇺EU▾ [GET/dedicated/nasha/{serviceName}/partition/{partitionName}/snapshot](https://eu.api.ovh.com/console/?section=/dedicated/nasha&branch=v1#get-/dedicated/nasha/-serviceName-/partition/-partitionName-/snapshot) | Parameter | Required | Description | | --------------- | -------- | -------------------------------------- | | `serviceName` | Yes | Le nom interne de votre service NAS-HA | | `partitionName` | Yes | Nom de la partition | ### Ajout d'un intervalle de snapshot automatique Pour créer des snapshots automatiques supplémentaires à une fréquence sélectionnée, utilisez la route suivante : 🇪🇺EU▾ [POST/dedicated/nasha/{serviceName}/partition/{partitionName}/snapshot](https://eu.api.ovh.com/console/?section=/dedicated/nasha&branch=v1#post-/dedicated/nasha/-serviceName-/partition/-partitionName-/snapshot) | Parameter | Required | Description | | --------------- | -------- | ------------------------------------------------------------------------------------------ | | `serviceName` | Yes | Le nom interne de votre service NAS-HA | | `partitionName` | Yes | Nom de la partition | | `snapshotType` | Yes | Une fréquence pour le snapshot : _day-1_, _day-2_, _day-3_, _day-7_, _hour-1_, ou _hour-6_ | ### Récupération des informations sur les snapshots automatiques Pour récupérer les détails d'un snapshot automatique, utilisez la route suivante : 🇪🇺EU▾ [GET/dedicated/nasha/{serviceName}/partition/{partitionName}/snapshot/{snapshotType}](https://eu.api.ovh.com/console/?section=/dedicated/nasha&branch=v1#get-/dedicated/nasha/-serviceName-/partition/-partitionName-/snapshot/-snapshotType-) | Parameter | Required | Description | | --------------- | -------- | ---------------------------------------------------------------------------------------------- | | `serviceName` | Yes | Le nom interne de votre service NAS-HA | | `partitionName` | Yes | Nom de la partition | | `snapshotType` | Yes | La fréquence de snapshot concernée : _day-1_, _day-2_, _day-3_, _day-7_, _hour-1_, ou _hour-6_ | ### Suppression d'un intervalle de snapshot automatique Utilisez la route suivante pour supprimer une fréquence de snapshot automatique : 🇪🇺EU▾ [DELETE/dedicated/nasha/{serviceName}/partition/{partitionName}/snapshot/{snapshotType}](https://eu.api.ovh.com/console/?section=/dedicated/nasha&branch=v1#delete-/dedicated/nasha/-serviceName-/partition/-partitionName-/snapshot/-snapshotType-) | Parameter | Required | Description | | --------------- | -------- | ---------------------------------------------------------------------------------------------- | | `serviceName` | Yes | Le nom interne de votre service NAS-HA | | `partitionName` | Yes | Nom de la partition | | `snapshotType` | Yes | La fréquence de snapshot concernée : _day-1_, _day-2_, _day-3_, _day-7_, _hour-1_, ou _hour-6_ | Vous pouvez également utiliser des snapshots instantanés avec votre NAS-HA (snapshots personnalisés) via les endpoints suivants. ### Listing des snapshots personnalisés Utilisez la route suivante pour récupérer des snapshots personnalisés existants : 🇪🇺EU▾ [GET/dedicated/nasha/{serviceName}/partition/{partitionName}/customSnapshot](https://eu.api.ovh.com/console/?section=/dedicated/nasha&branch=v1#get-/dedicated/nasha/-serviceName-/partition/-partitionName-/customSnapshot) | Parameter | Required | Description | | --------------- | -------- | -------------------------------------- | | `serviceName` | Yes | Le nom interne de votre service NAS-HA | | `partitionName` | Yes | Nom de la partition | ### Création d'un snapshot personnalisé Pour ajouter un snapshot manuel, utilisez la route suivante : 🇪🇺EU▾ [POST/dedicated/nasha/{serviceName}/partition/{partitionName}/customSnapshot](https://eu.api.ovh.com/console/?section=/dedicated/nasha&branch=v1#post-/dedicated/nasha/-serviceName-/partition/-partitionName-/customSnapshot) | Parameter | Required | Description | | --------------- | -------- | ---------------------------------------------------------------------- | | `serviceName` | Yes | Le nom interne de votre service NAS-HA | | `partitionName` | Yes | Nom de la partition | | `expiration` | | Une date d'expiration facultative, par exemple : 2022-06-24 (ISO 8601) | | `name` | Yes | Nom du snapshot. | ### Récupération des informations d'un snapshot personnalisé Pour afficher les détails d'un snapshot personnalisé, utilisez la route suivante : 🇪🇺EU▾ [GET/dedicated/nasha/{serviceName}/partition/{partitionName}/customSnapshot/{name}](https://eu.api.ovh.com/console/?section=/dedicated/nasha&branch=v1#get-/dedicated/nasha/-serviceName-/partition/-partitionName-/customSnapshot/-name-) | Parameter | Required | Description | | --------------- | -------- | -------------------------------------- | | `serviceName` | Yes | Le nom interne de votre service NAS-HA | | `partitionName` | Yes | Nom de la partition | | `name` | Yes | Le nom du snapshot | ### Suppression d'un snapshot personnalisé Utilisez la route suivante pour supprimer un snapshot personnalisé : 🇪🇺EU▾ [DELETE/dedicated/nasha/{serviceName}/partition/{partitionName}/customSnapshot/{name}](https://eu.api.ovh.com/console/?section=/dedicated/nasha&branch=v1#delete-/dedicated/nasha/-serviceName-/partition/-partitionName-/customSnapshot/-name-) | Parameter | Required | Description | | --------------- | -------- | -------------------------------------- | | `serviceName` | Yes | Le nom interne de votre service NAS-HA | | `partitionName` | Yes | Nom de la partition | | `name` | Yes | Le nom du snapshot | ##### **Restauration de snapshots** L'API ne permet pas de restaurer les snapshots effectués. Les snapshots sont stockés en lecture seule sur la partition. Pour accéder aux snapshots depuis votre point de montage, vous devez accéder au répertoire `.zfs/snapshot` de votre partition. Par exemple, sur un service dont l'ID est `zpool-123456`, contenant une partition nommée `partition1` et dont vous avez créé un snapshot nommé `snap-snapshot01`. Vous pouvez retrouver le snapshot avec cette commande : ```bash ls -al /zpool-123456/partition1/.zfs/snapshot/snap-snapshot01/ ``` Pour restaurer votre snapshot, copiez-le depuis le chemin d'accès du fichier `.zfs` vers le nouveau répertoire où vous souhaitez restaurer le snapshot. Vous pouvez utiliser un outil comme rsync qui vous permet d'effectuer des restaurations. Plus d’informations dans la section [Aller plus loin](#gofurther) de ce guide. ## Aller plus loin [Montez votre NAS via un partage NFS](/fr/guides/storage-and-backup/file-storage/ha-nas/nas-nfs.md) [Montez votre NAS sur Windows Server via CIFS](/fr/guides/storage-and-backup/file-storage/ha-nas/nas-cifs.md) 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/).