Suivre et arrêter une restauration

Ce que fait la fonction

La page d'une restauration donne son état, son avancement, son résultat et la liste des fichiers qui ne sont pas revenus. Elle porte aussi le bouton qui arrête une restauration en cours.

Les chiffres de l'avancement sont ceux de l'agent de la machine cible. Rien n'avance de soi-même : tant que l'agent n'a envoyé aucun chiffre, le portail le dit.

Une restauration prend l'un de ces six états :

État	Ce qu'il veut dire
En attente	L'ordre est parti. La machine cible doit le confirmer sous 60 s.
En cours	L'agent écrit les fichiers.
Réussie	Tous les fichiers demandés sont revenus.
Partielle	Une partie des fichiers n'a pas été écrite.
Échouée	La restauration ne s'est pas faite. La page donne la cause.
Annulée	Un utilisateur a arrêté la restauration.

Prérequis

• Le rôle Lecture seule suffit pour lire l'état, l'avancement et les compteurs. Ce rôle ne voit ni le dossier cible ni les noms des fichiers en erreur : ce sont des données du client. Voir Rôles et droits.
• Le rôle Technicien ou Administrateur pour arrêter une restauration.
• Pour l'API : une clé API avec la portée read pour lire, et operate pour arrêter.

Ouvrir la page d'une restauration

Le portail ouvre cette page dès que vous lancez une restauration. Voir Restaurer des fichiers depuis le portail.

Pour y revenir plus tard :

1. Ouvrez le portail.
2. Dans la barre du haut, ouvrez Endpoints.
3. Ouvrez la machine.
4. Ouvrez l'onglet Restaurations.
5. Cliquez la ligne de la restauration.

Le titre de la page donne la machine cible. Sous le titre, le portail écrit « Demandée par », suivi du nom de l'utilisateur et de la date. Une restauration vers une machine d'un autre client porte l'étiquette Autre client.

Suivre l'avancement

État En attente

Le portail écrit « En attente de », suivi du nom de la machine cible, puis « La machine doit confirmer l'ordre sous 60 s. » Il affiche ensuite le nombre de secondes restantes.

Quand les 60 s passent sans réponse, il écrit « Pas encore de réponse. La page affiche le résultat dès qu'il arrive. »

État En cours

Le bloc Progression donne :

• la phase : Lecture du point de restauration, puis Écriture des fichiers ;
• Fichiers : le nombre de fichiers écrits, et le total quand l'agent le connaît ;
• Données : le volume écrit, et le total quand l'agent le connaît ;
• Temps passé ;
• Erreurs : le nombre de fichiers en erreur.

La barre de progression apparaît quand l'agent envoie un total. Sans total, le portail écrit « Le total n'est pas encore connu. La barre s'affiche quand l'agent l'envoie. » Avant le premier chiffre, il écrit « Pas encore de chiffres de la machine. »

L'agent envoie sa progression au moins toutes les 60 secondes, même sans changement.

Vous pouvez fermer la page : « Vous pouvez quitter cette page. La restauration continue. »

Lire le résultat

Le bloc Résultat s'ouvre sur une phrase :

État	Phrase du portail
Réussie	« … fichiers sont revenus sur », suivi du nom de la machine cible.
Partielle	« Restauration partielle : … fichiers n'ont pas été écrits. »
Annulée	« Annulée par », suivi du nom de l'utilisateur.
Échouée	« Échec : », suivi de la cause.

Sous la phrase, quatre compteurs : Restaurés, Données écrites, Déjà présents (non touchés) et Erreurs.

Le bloc donne ensuite la Machine cible, l'Emplacement, le Point de restauration, le nombre d'Éléments demandés, le Début, la Fin et la durée.

Après une restauration partielle, le portail écrit « Regardez les erreurs plus bas. Corrigez leur cause, puis restaurez de nouveau ces fichiers. »

Lire les erreurs de fichiers

Le tableau Fichiers non restaurés donne une ligne par fichier, avec son chemin et la cause.

BaaStide garde 100 erreurs au plus. Au-delà, le portail écrit « … autres erreurs ne sont pas affichées : la restauration garde les 100 premières. » Le compteur Erreurs donne le nombre total.

Avec le rôle Lecture seule, le portail écrit « Votre rôle ne permet pas de voir les noms des fichiers. » Les compteurs restent visibles.

Causes d'un fichier non restauré

Cause affichée	Ce que vous faites
« Chemin réservé au système »	Restaurez ce fichier dans un dossier séparé.
« Un lien remplace un dossier du chemin »	Retirez le lien sur la machine cible, puis restaurez de nouveau.
« Conflit de type : un dossier (ou un fichier) existe à cet endroit »	Renommez l'élément en place, puis restaurez de nouveau.
« Permission refusée »	Vérifiez le propriétaire et les droits du dossier cible.
« Disque plein »	Libérez de la place, puis restaurez de nouveau.
« Erreur d'écriture »	Vérifiez le disque de la machine cible, puis restaurez de nouveau.
« Données illisibles dans le point de restauration »	Choisissez un autre point de restauration.
« Nom non valide sur le système cible »	Restaurez ce fichier vers une machine du même système que la source.
« Deux noms ne diffèrent que par la casse »	Restaurez le deuxième fichier seul, dans un autre dossier.
« Fichier utilisé par un autre programme »	Fermez le programme, puis restaurez de nouveau ce fichier.
« Type de volume non pris en charge »	Choisissez un dossier cible sur un autre lecteur.
« Autre erreur »	Relancez la restauration. Si l'erreur revient, contactez le support.

Une restauration vers un partage réseau ajoute ses propres causes, qui nomment le partage.

Arrêter une restauration

1. Ouvrez la page de la restauration.
2. Cliquez Arrêter la restauration.
3. Lisez la question : « Arrêter la restauration ? Les fichiers déjà écrits restent en place. »
4. Cliquez Arrêter la restauration.
5. Le portail écrit « Arrêt demandé… ».

Une restauration En attente passe tout de suite à l'état Annulée. Une restauration En cours attend la réponse de l'agent, 60 secondes au plus ; sans réponse, BaaStide la passe à Annulée.

Un deuxième arrêt pendant cette attente n'envoie rien.

Le bouton n'apparaît que sur une restauration En attente ou En cours, et avec le rôle Technicien ou Administrateur.

Retrouver les restaurations d'une machine

L'onglet Restaurations d'une machine liste les restaurations où cette machine est la source ou la cible, de la plus récente à la plus ancienne.

1. Ouvrez la machine.
2. Ouvrez l'onglet Restaurations.
3. Lisez les colonnes : Origine, État, Début, Auteur, Source → cible, Point de restauration et Résultat.
4. Cliquez Voir plus pour la page suivante.

La colonne Origine porte Portail ou Ligne de commande.

Une restauration lancée en ligne de commande sur la machine n'a pas d'état dans le portail. Sa colonne État porte Ouverte, Fermée ou Expirée. Sa page écrit « Cette restauration a été lancée en ligne de commande sur », suivi du nom de la machine, puis « Le portail n'a pas son statut. »

Suivre par l'API ou par un assistant IA

1. Appelez GET /restore-sessions/{id} avec l'identifiant rendu au lancement.
2. Lisez status, cause, stats et progress. Le champ progress n'est rempli que pendant l'état running.
3. Lisez error_codes : le nombre d'erreurs par code, sans chemin, de la plus fréquente à la moins fréquente.
4. Lisez errors pour les chemins en échec, 100 au plus.
5. Appelez GET /endpoints/{id}/restore-sessions pour la liste d'une machine, comme source ou comme cible. La route rend 50 sessions par page par défaut, et 100 au plus. Suivez next_cursor.
6. Appelez POST /restore-sessions/{id}/cancel pour arrêter une restauration.

Le champ errors est vide pour le rôle Lecture seule, pour une clé API sans la portée browse et pour un appel d'assistant IA. Le champ error_codes reste rempli dans tous les cas.

Un assistant IA utilise les outils MCP get_restore_session et list_restore_sessions pour suivre, et cancel_restore pour arrêter.

Quand la restauration échoue

Cause affichée	Ce qui s'est passé	Ce que vous faites
« la machine n'a pas répondu »	La machine cible n'a pas répondu à l'ordre en 60 s. Rien n'a été écrit.	Vérifiez que l'agent de la machine cible est en ligne, puis relancez.
« plus de nouvelles de la machine »	L'agent n'a envoyé aucune progression pendant 15 min. Les fichiers déjà écrits restent en place.	Vérifiez que la machine est en ligne, puis relancez.
« la machine a redémarré »	L'agent a redémarré pendant la restauration. Les fichiers déjà écrits restent en place.	Relancez la restauration.
« agent trop ancien »	L'agent de la machine cible ne sait pas restaurer depuis le portail. Rien n'a été écrit.	Mettez l'agent à jour, ou restaurez sur la machine en ligne de commande.
« une autre restauration est en cours »	Une autre restauration tournait déjà sur la machine cible. Rien n'a été écrit.	Attendez la fin de l'autre restauration, puis relancez.
« restauration désactivée sur la machine »	Le client a coupé les restaurations depuis le portail sur cette machine. Rien n'a été écrit.	Demandez au client de les activer, ou restaurez en ligne de commande.
« dossier cible refusé »	L'agent a refusé le dossier cible : dossier protégé, ou propriétaire et droits non sûrs. Rien n'a été écrit.	Choisissez un autre dossier cible.
« la cible n'est pas un dossier »	Le chemin cible est un fichier ou un lien. Rien n'a été écrit.	Choisissez un dossier, ou un chemin qui n'existe pas encore.
« ordre refusé par l'agent »	Une valeur de l'ordre n'a pas passé les contrôles de l'agent. Rien n'a été écrit.	Mettez l'agent à jour, puis relancez.
« erreur sur l'agent »	L'agent a arrêté la restauration sur une erreur. Rien, ou une partie seulement, a été écrit.	Relancez la restauration.
« la restauration ne s'est pas terminée »	La restauration a commencé sans se terminer. Une partie des fichiers peut être écrite.	Lisez les erreurs de fichiers, puis relancez.

Quand la cause est « la machine n'a pas répondu » ou « plus de nouvelles de la machine », la page affiche un bouton qui ouvre la machine cible.

Limites et précautions

• Les chiffres viennent de l'agent. Une restauration sans total connu n'a pas de barre de progression.
• Une restauration arrêtée ne remet rien en arrière. Les fichiers déjà écrits restent en place.
• Un état Partielle est un état final. Pour les fichiers qui manquent, lancez une nouvelle restauration.
• BaaStide garde 100 erreurs de fichiers au plus par restauration. Le compteur Erreurs donne le nombre réel.
• Les chemins et le dossier cible sont des données du client. Le rôle Lecture seule, une clé API sans la portée browse et un assistant IA ne les lisent pas.
• Le portail n'affiche pas l'avancement d'une restauration lancée en ligne de commande sur la machine. Il affiche seulement l'état de sa session de lecture.
• Une restauration en ligne de commande ne s'arrête pas depuis le portail. Elle se ferme sur la machine.
• Le journal d'audit garde la demande de restauration, la demande d'arrêt et la fin de la restauration. La ligne de fin porte les compteurs, jamais un chemin. Voir Journal d'audit.
• Une restauration n'est pas une tâche de sauvegarde : elle n'apparaît pas dans la liste des tâches. Voir Suivre une tâche de sauvegarde.

Référence

• API : Get restore session, List restore sessions et Cancel restore session.
• Outils MCP : get_restore_session et list_restore_sessions, et cancel_restore.