Trouver le bon point de restauration

Ce que fait un point de restauration

Un point de restauration porte l'état des données sauvegardées d'une machine à une date. Chaque sauvegarde réussie ou partielle en crée un. Voir Mots utilisés.

Avant de restaurer, vous choisissez un point de restauration. Vous le parcourez comme un explorateur de fichiers, vous y cherchez un fichier par son nom, et vous mesurez la taille de votre sélection.

BaaStide lit le point de restauration dans le stockage, pas sur la machine. La machine qui a fait la sauvegarde peut donc être arrêtée ou hors ligne. Le portail l'écrit : « Lecture depuis le stockage : la machine peut être hors ligne. »

BaaStide ne lit jamais le contenu d'un fichier pendant ce parcours. Il lit le nom, le type, la taille et la date de modification de chaque élément.

Prérequis

• Le rôle Technicien ou Administrateur pour parcourir un point de restauration, y chercher un fichier et mesurer une sélection. Le rôle Lecture seule voit la liste des points, pas leur contenu. Le portail écrit alors « Votre rôle voit les points de restauration, pas leur contenu. Demandez à un administrateur ou à un technicien du MSP. » Voir Rôles et droits.
• Au moins une sauvegarde réussie ou partielle sur la machine. Voir Sauvegarder maintenant.
• Pour l'API : une clé API avec la portée read pour lister les points de restauration, et la portée browse pour parcourir un point, y chercher un fichier et mesurer une sélection.

L'agent n'a pas besoin d'être en ligne.

Où se trouvent les points de restauration

Chaque type de sauvegarde a sa propre liste de points de restauration.

Type de sauvegarde	Où lire les points de restauration
Fichiers	Liste Point de restauration, en haut de l'assistant Restaurer des fichiers
Image	Liste Image de la page Restauration bare metal, après l'appairage du média
SQL Server	Tableau Points de restauration SQL Server, onglet SQL Server de la machine
VM Hyper-V	Onglet VM de l'hôte, puis la page de restauration de la VM
VM et conteneurs Proxmox	Onglet VM et conteneurs du nœud, puis la page de restauration de l'invité

Voir Choisir la bonne restauration pour le chemin complet de chaque restauration.

Lister les points de restauration de fichiers

1. Ouvrez le portail.
2. Dans la barre du haut, ouvrez Endpoints.
3. Ouvrez la machine.
4. Cliquez Restaurer des fichiers.
5. Lisez la liste Point de restauration.

La liste porte les points de restauration de fichiers seulement. Elle est triée du plus récent au plus ancien. Le premier porte la mention (le plus récent). Chaque ligne donne la date, puis le volume source du point.

Sous la liste, le portail écrit le nombre de points chargés : « 12 points de restauration de fichiers ». Quand il reste des points plus anciens, il écrit « Les 50 points de restauration de fichiers les plus récents » et il affiche le bouton Afficher les points de restauration plus anciens.

À droite de la liste, le portail donne les Sources du point : les chemins que la politique a sauvegardés.

Quand la machine n'a aucun point de restauration de fichiers, le portail écrit « Cette machine n'a pas encore de point de restauration de fichiers. Rien à restaurer. »

Choisir un point plus ancien

1. Cliquez Afficher les points de restauration plus anciens.
2. Attendez la fin du chargement.
3. Répétez jusqu'à voir la date voulue.
4. Choisissez le point dans la liste Point de restauration.

La date affichée est celle de la fin de la tâche de sauvegarde, lue par la plateforme. C'est aussi la date que la rétention utilise. La date écrite par la machine n'est pas affichée.

Quand votre sélection n'est pas vide, le portail demande d'abord : « Changer de point de restauration ? Votre sélection appartient à ce point de restauration. Elle sera vidée. »

Parcourir un point de restauration

1. Choisissez le point de restauration.
2. Lisez la liste Contenu du point de restauration.
3. Cliquez une ligne de dossier pour l'ouvrir.
4. Descendez jusqu'au dossier voulu.
5. Cochez les fichiers et les dossiers à restaurer.

Le portail charge un dossier par pages, et il trie chaque niveau comme un explorateur de fichiers : les dossiers et les liens d'abord, puis les fichiers, de A à Z.

La première ligne, Tout le point de restauration, coche le point entier.

Sur une sauvegarde Windows, un lecteur du premier niveau s'affiche C:. Les partages réseau sauvegardés s'affichent sous Partages réseau, avec le nom de chaque partage et son adresse actuelle.

Ce que le portail écrit quand un dossier ne s'ouvre pas

Message	Ce que vous faites
« Ce dossier a plus de 1 000 000 éléments. »	Cliquez Chercher dans ce dossier. Le parcours ne descend pas dans un dossier de cette taille.
« Pas de réponse à temps (30 s). »	Cliquez Réessayer.
« Le service est occupé. »	Attendez. Le portail donne le délai, il réessaie une fois, puis il propose Réessayer maintenant.
« Ce dossier n'existe plus dans le point de restauration. »	Choisissez un autre dossier.
« Point de restauration introuvable »	La rétention a supprimé ce point. Choisissez-en un plus récent.
« Impossible de lire le point de restauration »	Réessayez dans quelques minutes. Si le problème continue, contactez le support.
« Clé du stockage indisponible »	Réessayez plus tard.

Chercher un fichier dans un point de restauration

Utilisez la recherche quand le client connaît le nom du fichier, mais pas son dossier.

1. Choisissez le point de restauration.
2. Ouvrez le dossier de départ de la recherche, ou restez à la racine.
3. Tapez le nom, ou une partie du nom, dans le champ de recherche. Son texte d'aide donne le dossier de départ. À la racine, il écrit : Chercher dans « Tout le point de restauration ».
4. Cliquez Chercher.
5. Lisez les résultats. Chaque ligne donne le chemin complet de l'élément.
6. Cochez les éléments à restaurer.

Le portail écrit le dossier de la recherche sous la barre, après Recherche dans. La recherche couvre ce dossier et tous ses sous-dossiers.

Le nom cherché est une partie du nom, sans tenir compte des majuscules. Ce n'est pas un motif : * et ? comptent comme des caractères normaux. Un nom porte 255 octets au plus.

La ligne d'état donne le nombre de résultats et le nombre d'éléments lus, par exemple « 18 résultats · 42 310 éléments lus ». Le bouton Résultats suivants charge la page suivante. Une page peut ne donner aucun résultat et avoir une page suivante : continuez.

Ajouter un filtre à la recherche

1. Cliquez Filtres.
2. Choisissez un Type : Fichiers et dossiers, Fichiers ou Dossiers.
3. Tapez une Taille (fichiers) minimale, une taille maximale, et choisissez l'unité (Kio, Mio ou Gio).
4. Sous Modifié, choisissez une date après le et une date avant le.
5. Cliquez Chercher.

Une recherche demande au moins un nom ou un filtre. Sans rien, le portail écrit « Tapez un nom ou choisissez un filtre. »

Le portail refuse une taille minimale plus grande que la taille maximale, et une date « après le » postérieure à la date « avant le ». Il écrit la cause sous le champ.

Le nombre de filtres actifs s'affiche sur le bouton Filtres. Les filtres de la recherche en cours s'affichent en étiquettes à côté du dossier de recherche.

Quand la recherche s'arrête avant la fin

Une recherche lit 2 000 000 éléments au plus. Au-delà, le portail écrit « Recherche incomplète. Plus de 2 000 000 éléments lus. Précisez le dossier de départ ou ajoutez un filtre. »

Dans ce cas, la liste des résultats n'est pas complète. Reprenez la recherche dans un dossier plus bas, ou ajoutez un filtre de type, de taille ou de date.

Mesurer la taille d'une sélection

La barre du bas donne le nombre d'éléments cochés et leur taille.

Un fichier porte sa taille dans le point de restauration. Un dossier n'en porte pas : BaaStide doit la calculer. Tant que le calcul n'a pas eu lieu, la barre écrit par exemple « 2,4 Gio + 3 dossiers ».

1. Cochez les fichiers et les dossiers.
2. Cliquez Calculer la taille.
3. Attendez la fin du calcul.
4. Lisez le total et le détail, par exemple « 18,2 Gio · 41 203 fichiers, 2 118 dossiers ».

Quand vous cochez Tout le point de restauration, le portail donne le volume source du point, sans calcul.

Le calcul lit 2 000 000 éléments au plus. Au-delà, le portail écrit « plus de », suivi de la taille : le chiffre est un minimum.

Le résultat est la taille des données dans le point de restauration. Ce n'est pas la place prise dans le dépôt.

Une sélection porte 1 000 éléments au plus. Au-delà, le portail écrit « 1 000 éléments au plus. Sélectionnez le dossier parent. » Un élément déjà contenu dans un dossier coché ne compte qu'une fois.

Lister les points de restauration par l'API ou par un assistant IA

1. Appelez GET /endpoints/{id}/snapshots.
2. Ajoutez backup_kind pour un seul type : files, baremetal, mssql, hyperv ou proxmox.
3. Ajoutez policy_id pour les points d'une seule politique.
4. Lisez items, puis suivez next_cursor pour la page suivante.

La route rend 50 points par page par défaut, et 100 au plus. Chaque point donne son identifiant, sa date, ses chemins sources, son volume source, le volume ajouté au dépôt et son nombre de fichiers. Cette route n'a pas de filtre de date.

Un assistant IA utilise l'outil MCP list_snapshots. Cet outil filtre par date : un jour (date), ou un intervalle (after et before). Sans résultat, il rend le point plus ancien et le point plus récent les plus proches.

Limites et précautions

• Le parcours, la recherche et le calcul de taille demandent le droit d'opération. Un rôle Lecture seule voit la liste des points de restauration et s'arrête là.
• Chaque appel de parcours, de recherche et de calcul de taille entre dans le journal d'audit.
• BaaStide ne rend jamais le contenu d'un fichier, ni son propriétaire, ni ses droits, ni la cible d'un lien.
• Un lien n'est jamais suivi pendant le parcours ni pendant la recherche.
• Un nom de fichier qui n'est pas de l'UTF-8 valide s'affiche avec le caractère de remplacement Unicode (U+FFFD). Vous ne pouvez ni l'ouvrir ni le cocher.
• La liste de l'assistant Restaurer des fichiers ne porte que les points de restauration de fichiers. Un lien vers une image ouvre le point de fichiers le plus récent, avec une note.
• Le portail lance deux appels de parcours au plus en même temps par machine. Au-delà, les appels attendent leur tour.
• Un appel refusé parce que le service est occupé n'est pas une erreur du point de restauration. Réessayez.
• La rétention supprime les points de restauration les plus anciens après chaque sauvegarde. Un point affiché peut disparaître pendant votre travail. Voir Planification et rétention.
• Une sauvegarde arrêtée ne donne pas de point de restauration. Voir Suivre une tâche de sauvegarde.
• Un assistant IA liste un dossier et cherche un fichier, mais il ne calcule pas la taille d'une sélection : aucun outil MCP ne le fait.
• Une restauration en ligne de commande ouvre une session de lecture sur les points de restauration de la machine, jusqu'à sa fermeture ou son expiration. L'onglet Restaurations de la machine la montre.

Référence

• API : Backups, routes GET /endpoints/{id}/snapshots, POST /endpoints/{id}/snapshots/{snapshot_id}/tree, POST /endpoints/{id}/snapshots/{snapshot_id}/search et POST /endpoints/{id}/snapshots/{snapshot_id}/selection-size.
• Outils MCP : list_snapshots, browse_snapshot, search_snapshot et list_snapshot_databases.
• CLI de l'agent : baastide restore --list liste les points de restauration depuis la machine.