Codes de cause d'une tâche
Ce que dit cette page
Une tâche qui ne réussit pas porte une cause. La cause est un code court, toujours le même
pour la même situation. Elle dit pourquoi la tâche n'a pas fait son travail.
Cette page liste chaque cause, sa signification et l'action à mener. Lisez-la quand le portail
affiche un code que vous ne connaissez pas, ou quand votre outil lit le champ cause de l'API.
Prérequis
- Le rôle
read pour lire une tâche dans le portail ou par l'API. Voir
Rôles et droits.
Où lire la cause d'une tâche
Une tâche porte une cause quand elle n'a pas fait tout son travail. Cela arrive quand son état
est échec, partielle, interrompue ou manquée. Une tâche annulée porte aussi
une cause : elle dit qui ou quoi l'a annulée.
Dans le portail
- Ouvrez la fiche de la tâche.
- Lisez le bloc du problème, en haut. Il donne la cause en une phrase, puis l'action à mener.
- Quand l'agent a envoyé un message, le portail l'affiche en dessous, avec un bouton de copie.
Ce message vient de l'agent et il est en anglais.
Par l'API
- Appelez
GET /jobs/{id}.
- Lisez le champ
cause. Il porte le code, ou null quand la plateforme n'a pas typé la cause.
- Pour une sauvegarde partielle, lisez
error_count (le nombre de fichiers non lus) et
file_error_codes (un nombre par code d'erreur de fichier).
Voir la référence de l'API.
Par un assistant IA
Un outil MCP de lecture rend, pour une tâche qui n'a pas réussi, un résumé typé : la cause, une
phrase fixe, le nombre d'erreurs par code de fichier et l'adresse de la fiche de la tâche dans le
portail. Ce résumé ne contient ni chemin de fichier, ni texte libre de l'agent. Voir les
outils MCP.
Causes du cycle de vie d'une sauvegarde
| Code | Ce qui s'est passé | Quoi faire |
|---|
no_ack | L'agent n'a pas répondu à l'ordre de démarrer. | Vérifiez que l'agent est en ligne, puis relancez la tâche. |
agent_unsupported | Cette version de l'agent ne sait pas exécuter ce type de tâche. | Mettez l'agent à jour, puis relancez la tâche. |
agent_too_old | L'agent est plus ancien que la version minimale de la plateforme, donc il est bloqué. | Mettez l'agent à jour, puis relancez la tâche. Voir Versions d'agent minimales par fonction. |
agent_offline | L'agent était hors ligne quand l'ordre est parti. | Démarrez l'agent, ou vérifiez son réseau, puis relancez la tâche. |
agent_error | L'agent a refusé l'ordre. | Lisez le message de l'agent sur la fiche de la tâche. |
repo_key_unavailable | La plateforme n'a pas pu lire la clé du dépôt. | Contactez le support. |
dispatch_failed | La plateforme n'a pas pu envoyer l'ordre à l'agent. | Relancez la tâche dans quelques minutes. |
backup_failed | L'agent a signalé une erreur et n'a fait aucune sauvegarde. | Lisez le message de l'agent sur la fiche de la tâche. |
no_progress | L'agent a cessé d'envoyer sa progression, donc la tâche a été arrêtée. | Vérifiez que la machine est allumée, puis relancez la tâche. |
not_running | L'agent a redémarré et n'exécutait plus cette tâche. | Relancez la tâche. |
user_cancelled | Un utilisateur a annulé la tâche. | Rien à faire. |
snapshot_conflict | Le point de restauration de cette sauvegarde était déjà enregistré pour une autre tâche. | Contactez le support. |
endpoint_deleted | L'endpoint a été supprimé, donc la tâche a été arrêtée. | Rien à faire. |
pre_hook_failed | Le script avant la sauvegarde a échoué, donc aucune sauvegarde n'a été faite. | Corrigez le script ou la machine, puis relancez la tâche. |
Causes des partages réseau
| Code | Ce qui s'est passé | Quoi faire |
|---|
share_unreachable | Serveur injoignable : nom introuvable, ou le serveur ne répond pas. | Vérifiez le réseau et l'adresse du serveur. |
share_auth_failed | Le serveur refuse le compte ou le mot de passe. | Vérifiez le compte et le mot de passe du partage. |
share_not_found | Le partage ou l'export n'existe pas sur le serveur. | Vérifiez le nom du partage. |
share_access_denied | La connexion a réussi, mais le compte, ou l'adresse de l'agent, ne peut pas lire la racine du partage. | Donnez au compte un accès en lecture au partage. |
share_unsupported | Protocole non pris en charge : SMB 3 refusé par le serveur, ou prise en charge absente sur la machine. | Activez SMB 3 sur le serveur, ou choisissez un autre partage. |
share_encryption_unavailable | Le chiffrement est exigé, mais le serveur ne chiffre pas. | Activez le chiffrement sur le serveur, ou retirez cette exigence du partage. |
share_signing_unavailable | Le serveur ne signe pas et ne chiffre pas la connexion. | Exigez la signature sur le serveur, ou activez le chiffrement. |
shares_disabled | Les partages réseau sont désactivés sur la machine. | Réactivez les partages réseau sur la machine. |
agent_updating | L'agent se mettait à jour. | Rien à faire. La prochaine sauvegarde se fait avec la nouvelle version. |
share_credential_unavailable | Le mot de passe du partage ne peut pas être lu sur le serveur. | Saisissez à nouveau le mot de passe du partage. |
Causes de SQL Server
| Code | Ce qui s'est passé | Quoi faire |
|---|
mssql_rights_missing | Le compte de connexion SQL Server n'est pas membre de sysadmin. | Ajoutez le compte au rôle sysadmin, puis relancez la tâche. |
mssql_auth_failed | SQL Server a refusé le compte de connexion. | Vérifiez les paramètres de connexion de l'instance. |
mssql_unreachable | L'agent n'a pas pu se connecter à SQL Server. | Vérifiez que l'instance tourne et qu'elle accepte TCP/IP ou les canaux nommés. |
mssql_backup_failed | SQL Server n'a pas pu sauvegarder les bases. | Lisez le journal de la tâche, puis relancez la tâche. |
mssql_db_missing | Une base de la politique n'est pas sur l'instance. | Mettez la politique à jour. |
mssql_credential_unavailable | La plateforme n'a pas pu lire le mot de passe SQL Server. | Saisissez à nouveau les paramètres de connexion de l'instance. |
Causes de l'image complète d'une machine
| Code | Ce qui s'est passé | Quoi faire |
|---|
unsupported_os | Le système de la machine ne permet pas la sauvegarde d'image. | Sauvegardez les fichiers de la machine. |
unsupported_layout | La disposition des disques de la machine ne permet pas la sauvegarde d'image. | Sauvegardez les fichiers de la machine. |
domain_controller | La sauvegarde d'image d'un contrôleur de domaine n'est pas acceptée. | Sauvegardez les fichiers de la machine. |
baremetal_unsupported_boot | La machine démarre en BIOS, ou son disque système est en MBR. La sauvegarde d'image demande UEFI et GPT. | Convertissez le disque en GPT, ou sauvegardez les fichiers. |
vss_failed | Windows n'a pas pu créer de copie d'ombre (VSS) des disques. | Vérifiez le service VSS sur la machine, puis relancez la tâche. |
image_read_failed | L'agent n'a pas pu lire un disque de la machine. | Vérifiez les disques de la machine, puis relancez la tâche. |
upload_failed | L'agent n'a pas pu envoyer l'image vers le stockage. | Vérifiez le réseau de la machine, puis relancez la tâche. |
internal | L'agent s'est arrêté sur une erreur interne. | Relancez la tâche. Si elle échoue encore, contactez le support. |
Causes du planificateur
| Code | Ce qui s'est passé | Quoi faire |
|---|
window_ended | La tâche n'a pas démarré, ou ne s'est pas terminée, avant la fin de sa fenêtre. | Allongez la fenêtre de la politique, ou vérifiez que la machine est en ligne à cette heure. |
repo_migrating | La plateforme déplaçait le dépôt à l'heure prévue. | Rien à faire. |
newer_run | Une exécution plus récente de la même politique a remplacé celle-ci. | Rien à faire. |
repo_busy | Une autre tâche du même dépôt était en cours à l'heure prévue. | Rien à faire. Si cela se répète, écartez les heures des politiques. |
preempted_by_backup | Une sauvegarde était due, donc cette tâche a été arrêtée ou reportée. | Rien à faire. |
worker_lost | La plateforme a perdu cette tâche avant sa fin. | Rien à faire. La plateforme la relance. |
msp_suspended | Le compte est suspendu, donc la tâche a été annulée. | Le compte doit être réactivé pour que les sauvegardes repartent. |
resume_pending | Une sauvegarde devait reprendre d'abord, donc cette tâche n'a pas démarré. | Rien à faire. |
restore_session_open | Une restauration était ouverte sur le dépôt, donc cette tâche n'a pas démarré. | Rien à faire. |
Pour la cause window_ended, le portail affiche deux phrases différentes : une quand la tâche
n'a pas pu démarrer dans sa fenêtre, une autre quand elle n'a pas pu se terminer dans sa fenêtre.
L'API rend le même code dans les deux cas. L'état de la tâche fait la différence : manquée
quand elle n'a pas démarré, interrompue quand elle n'a pas fini.
Causes de la licence
| Code | Ce qui s'est passé | Quoi faire |
|---|
license_required | La licence de la plateforme ne permet pas les sauvegardes maintenant, donc la tâche a été annulée. Les restaurations marchent toujours. | Demandez à l'administrateur de la plateforme d'importer une licence valide. |
license_invalid | L'agent a refusé la licence de la plateforme, donc aucune sauvegarde n'a été faite. Les restaurations marchent toujours. | Vérifiez que l'agent est enrôlé sur cette plateforme et que son horloge est juste. |
Causes de la politique de sauvegarde
| Code | Ce qui s'est passé | Quoi faire |
|---|
policy_disabled | La politique de sauvegarde a été coupée, donc la tâche a été annulée. | Réactivez la politique si la sauvegarde est encore voulue. |
policy_deleted | La politique de sauvegarde a été supprimée, donc la tâche a été annulée. | Rien à faire. |
Causes des tâches de maintenance du dépôt
| Code | Ce qui s'est passé | Quoi faire |
|---|
init_failed | Le dépôt n'a pas pu être préparé. | Contactez le support. |
unlock_failed | La maintenance du dépôt a échoué au déverrouillage. | Rien à faire. La plateforme réessaie. |
forget_failed | La maintenance du dépôt a échoué sur la rétention. | Rien à faire. La plateforme réessaie. |
prune_failed | La maintenance du dépôt a échoué sur le nettoyage. | Rien à faire. La plateforme réessaie. |
check_failed | La vérification du dépôt a trouvé un problème. | Contactez le support. |
reset_first_backup_failed | La suppression d'une première sauvegarde abandonnée a échoué. | Rien à faire. La plateforme réessaie. |
repo_has_snapshot | Le dépôt a un point de restauration, donc la première sauvegarde abandonnée n'a pas été supprimée. | Rien à faire. |
reset_not_due | La règle a changé, ou la sauvegarde a avancé, donc la première sauvegarde abandonnée n'a pas été supprimée. | Rien à faire. |
move_copy_failed | Le déplacement du dépôt a échoué pendant la copie. Les données restent à leur place. | Contactez le support. |
move_check_failed | Le déplacement du dépôt a échoué pendant la vérification. Les données restent à leur place. | Contactez le support. |
repo_deleted | Le dépôt a été supprimé, donc la tâche a été arrêtée. | Rien à faire. |
Causes de la mise à jour d'un agent
| Code | Ce qui s'est passé | Quoi faire |
|---|
no_result | L'agent n'a pas signalé la fin de la tâche. Cette cause ferme aussi une sauvegarde complète de sécurité de SQL Server. | Vérifiez la version de l'agent. Voir Versions d'agent minimales par fonction. |
agent_busy | L'agent exécutait une tâche, donc la mise à jour a été reportée. | Rien à faire. |
update_failed | L'agent n'a pas pu installer sa mise à jour. L'agent garde sa version. | Voir Mettre un agent à jour à la main. |
rolled_back | La nouvelle version de l'agent n'a pas démarré, donc l'agent est revenu à sa version précédente. | Voir Mise à jour automatique de l'agent. |
Deux valeurs de résumé
Le résumé typé d'une tâche porte deux valeurs de plus. Elles ne viennent pas du champ cause.
| Valeur | Ce qu'elle veut dire |
|---|
file_errors | La sauvegarde a été faite, mais l'agent n'a pas pu lire certains fichiers. Le journal de la tâche peut nommer ces fichiers. |
unknown | La tâche n'a pas réussi et la plateforme n'a donné aucune cause typée. Lisez la fiche de la tâche. |
Codes d'erreur de fichier
Une sauvegarde partielle a été faite, mais certains fichiers n'ont pas pu être lus. La
plateforme compte les erreurs par code. Elle ne sort ni le chemin, ni le texte de l'erreur.
| Code | Ce qu'il veut dire |
|---|
permission_denied | Le compte de l'agent n'a pas le droit de lire le fichier. |
file_in_use | Un autre programme tenait le fichier. |
not_found | Le fichier a disparu pendant la sauvegarde. |
io_error | Le disque a renvoyé une erreur de lecture. |
name_too_long | Le nom du fichier est trop long. |
other | Une autre erreur de lecture. |
Une erreur sur un partage réseau porte un des codes de partage de cette page, et non un de ces
six codes.
Limites et précautions
- Une cause ne nomme aucun fichier. Pour les fichiers d'une sauvegarde partielle, ouvrez la fiche
de la tâche dans le portail et lisez son journal.
- Le portail traduit les causes les plus fréquentes. Quand il ne connaît pas un code, il affiche
le code tel quel. Revenez alors à cette page.
- Le champ
cause de l'API est une chaîne de texte, et non une liste fermée. Une nouvelle version
du produit peut ajouter un code. Votre outil doit accepter un code qu'il ne connaît pas.
- Une sauvegarde d'image ne se relance pas depuis le portail. Elle a lieu à l'heure de sa
politique.
- Les deux causes de licence annulent la tâche sans alerte. Les restaurations continuent de
marcher.
Référence liée