NAS-HA - Gestion des snapshots via API

Apprenez à gérer les snapshots du NAS-HA via l'API OVHcloud

Dernière mise à jour le 20/07/2022

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

En pratique

N’hésitez pas à vous rendre sur la page FAQ NAS-HA 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://ca.api.ovh.com/console/#/dedicated/nasha.

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 :

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 :

API :
Paramètres :

serviceName *

Le nom interne de votre service NAS-HA

partitionName *

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 :

API :
Paramètres :

serviceName *

Le nom interne de votre service NAS-HA

partitionName *

Nom de la partition

snapshotType *

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 :

API :
Paramètres :

serviceName *

Le nom interne de votre service NAS-HA

partitionName *

Nom de la partition

snapshotType *

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 :

API :
Paramètres :

serviceName *

Le nom interne de votre service NAS-HA

partitionName *

Nom de la partition

snapshotType *

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 :

API :
Paramètres :

serviceName *

Le nom interne de votre service NAS-HA

partitionName *

Nom de la partition

Création d'un snapshot personnalisé

Pour ajouter un snapshot manuel, utilisez la route suivante :

API :
Paramètres :

serviceName *

Le nom interne de votre service NAS-HA

partitionName *

Nom de la partition

expiration

Une date d'expiration facultative, par exemple : 2022-06-24 (ISO 8601)

name *

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 :

API :
Paramètres :

serviceName *

Le nom interne de votre service NAS-HA

partitionName *

Nom de la partition

name *

Le nom du snapshot

Suppression d'un snapshot personnalisé

Utilisez la route suivante pour supprimer un snapshot personnalisé :

API :
Paramètres :

serviceName *

Le nom interne de votre service NAS-HA

partitionName *

Nom de la partition

name *

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 :

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 de ce guide.

Aller plus loin

Montez votre NAS via un partage NFS

Montez votre NAS sur Windows Server via CIFS

Échangez avec notre communauté d'utilisateurs sur https://community.ovh.com/.


Did you find this guide useful?

Please feel free to give any suggestions in order to improve this documentation.

Whether your feedback is about images, content, or structure, please share it, so that we can improve it together.

Your support requests will not be processed via this form. To do this, please use the "Create a ticket" .

Thank you. Your feedback has been received.


These guides might also interest you...

OVHcloud Community

Accedez à votre espace communautaire. Posez des questions, recherchez des informations, publiez du contenu et interagissez avec d’autres membres d'OVHcloud Community.

Echanger sur OVHcloud Community