Restaurer une VM ou un conteneur Proxmox

Ce que fait une restauration Proxmox

Une restauration Proxmox relit un point de restauration d'une VM ou d'un conteneur LXC, puis elle réécrit ses disques ou ses volumes et sa configuration sur un nœud Proxmox VE. Elle demande une politique VM et conteneurs Proxmox avec au moins une sauvegarde réussie. Voir Sauvegarder les VM et conteneurs d'un nœud Proxmox VE.

BaaStide propose deux modes :

Mode	Ce qu'il fait
Une nouvelle VM ou Un nouveau conteneur	Crée une copie avec un nouvel ID Proxmox, à côté de l'invité actuel. L'invité actuel ne change pas.
La VM actuelle ou Le conteneur actuel	Ramène l'invité au point de restauration. Il garde son ID Proxmox. Ses disques ou ses volumes actuels sont supprimés quand la restauration réussit.

Le mode nouvel invité s'exécute sur le nœud d'origine, ou sur un autre nœud Proxmox VE du même client. Le mode invité actuel s'exécute sur le nœud d'origine seulement.

Une restauration de VM ne rend pas un fichier pris dans la VM. Pour restaurer des fichiers d'une VM, installez aussi l'agent BaaStide dans la VM. Pour les fichiers d'un conteneur, voir Restaurer les fichiers d'un conteneur.

Prérequis

• Au moins un point de restauration de l'invité. Voir Trouver le bon point de restauration.
• Le rôle Technicien ou Administrateur. Un rôle Lecture seule n'ouvre pas la page de restauration : le portail écrit alors « Votre rôle ne permet pas cette action. »
• Le nœud cible en ligne, avec un agent qui exécute Proxmox, et Proxmox VE 9.0 ou plus récent.
• Un stockage du nœud cible qui accepte le contenu voulu : images pour une VM, rootdir pour un conteneur.
• Assez d'espace libre sur ce stockage : la taille des disques ou des fichiers, plus 10 %.
• Pour le mode invité actuel : une session du portail. Une clé API du MSP et un assistant IA reçoivent une réponse 403.

Une restauration n'a pas besoin d'une licence qui permet les sauvegardes.

Ouvrir la page de restauration

1. Ouvrez le portail.
2. Ouvrez Endpoints, puis le nœud Proxmox VE.
3. Ouvrez l'onglet VM et conteneurs.
4. Cliquez Restaurer sur la ligne de la VM ou du conteneur.

La page porte le titre Restaurer nom de l'invité et le texte « Restaurez les disques ou les volumes et la configuration depuis un point de restauration. »

Le bouton Restaurer n'apparaît que lorsque l'invité a un point de restauration. Sur la page de restauration, quand aucun point n'existe, le portail écrit « Cette VM n'a pas encore de point de restauration. » ou « Ce conteneur n'a pas encore de point de restauration. » Quand l'invité a quitté la liste du nœud, il écrit « Cette VM ou ce conteneur n'est pas dans la liste du nœud. »

Choisir le point de restauration

1. Lisez la liste Point de restauration. Elle donne les points de cet invité, du plus récent au plus ancien, avec leur date et leur taille.
2. Choisissez un point.
3. Cliquez Voir plus quand le point que vous cherchez n'est pas dans la liste.

Quand le point choisi est cohérent après plantage, le portail écrit « Ce point de restauration est cohérent après plantage : les systèmes de fichiers n'ont pas été gelés. »

Restaurer comme nouvel invité

1. Ouvrez la page de restauration de l'invité.
2. Choisissez le Point de restauration.
3. Dans Restaurer comme, gardez Une nouvelle VM ou Un nouveau conteneur.
4. Lisez la liste Nœud. Elle s'ouvre sur le nœud d'origine. Voir Restaurer sur un autre nœud du client.
5. Lisez le Nom de la nouvelle VM, ou le Nom d'hôte du nouveau conteneur. Le portail propose le nom de l'invité suivi de -restore-<date du jour>. Changez-le si nécessaire. Le nom porte 100 caractères au plus.
6. Choisissez le Stockage. Voir Choisir le stockage.
7. Pour une VM sur un stockage de fichiers, choisissez le Format des disques. Voir Choisir le format des disques.
8. Choisissez le Bridge réseau. Voir Choisir le bridge réseau.
9. Choisissez les Adresses MAC. Voir Choisir les adresses MAC.
10. Lisez les messages de la page : espace libre, TPM, conteneur privilégié, mappage d'ID, points de montage absents.
11. Pour une VM avec un TPM virtuel, cochez J'ai la clé de récupération BitLocker de cette VM. Voir TPM virtuel et BitLocker.
12. Cochez Démarrer après la restauration si l'invité doit démarrer tout de suite.
13. Cliquez Restaurer comme nouvelle VM ou Restaurer comme nouveau conteneur.

Le portail écrit « La restauration de nom a démarré. », puis il ouvre la page de suivi de la restauration.

Le nouvel invité reçoit un ID Proxmox libre du cluster. Une nouvelle VM reçoit aussi un nouvel identifiant SMBIOS : BaaStide la voit comme une VM différente de la source.

Restaurer sur un autre nœud du client

Le mode nouvel invité accepte un autre nœud Proxmox VE, à condition qu'il appartienne au même client que le nœud d'origine.

1. Ouvrez la page de restauration de l'invité.
2. Choisissez le Point de restauration.
3. Ouvrez la liste Nœud. Elle donne le nœud d'origine, marqué (ce nœud), puis les autres nœuds du client, avec leur version de Proxmox VE.
4. Choisissez un nœud.
5. Le portail écrit « La VM est restaurée sur nom avec un nouvel ID. La VM sur source ne change pas. »
6. Vérifiez le stockage et le bridge : ils viennent maintenant du nœud choisi.
7. Cliquez Restaurer comme nouvelle VM ou Restaurer comme nouveau conteneur.

Un nœud qui ne peut pas recevoir cet invité est grisé. La liste écrit son nom, puis sa cause :

Cause	Texte du portail
Pas un nœud Proxmox VE	« pas un nœud Proxmox VE »
Version de Proxmox hors support	« version Proxmox hors support »
Version de machine trop récente	« version de machine de la VM trop récente pour ce nœud »
Agent trop ancien	« agent trop ancien »
Suppression demandée	« suppression en attente »
Agent hors ligne	« agent hors ligne »

Un nœud d'un autre client n'est jamais dans la liste. Quand une demande nomme un nœud d'un autre client, le portail écrit « Ce nœud appartient à un autre client. Choisissez un nœud du même client. »

Quand la liste des nœuds ne se charge pas, le portail écrit « La liste des nœuds ne s'est pas chargée. Vous pouvez quand même restaurer sur ce nœud. »

Une VM dont la version de machine QEMU est plus récente que le QEMU du nœud cible est refusée. Le portail écrit « Le nœud ne peut pas faire tourner la version de machine de la VM : son Proxmox VE est plus ancien que celui de la source. Choisissez un nœud avec le même Proxmox VE ou un plus récent. »

Quand vous gardez Même bridge que la source, s'il existe sur un autre nœud, le portail prévient : « Si nom n'a pas le bridge de la source, les cartes réseau sont déconnectées (link down). Choisissez un bridge du nœud pour les connecter. »

Remplacer l'invité actuel

Ce mode supprime les disques ou les volumes en place. Lisez cette partie en entier avant de l'utiliser.

1. Ouvrez la page de restauration de l'invité.
2. Choisissez le Point de restauration.
3. Dans Restaurer comme, choisissez La VM actuelle ou Le conteneur actuel.
4. Choisissez le Stockage, ou gardez Stockage actuel de chaque disque.
5. Choisissez le Bridge réseau. L'invité garde ses adresses MAC.
6. Cochez Démarrer après la restauration. La case est déjà cochée quand l'invité est en marche.
7. Lisez la partie Arrêt : « L'agent demande au système invité de s'arrêter, puis attend jusqu'à 10 minutes. »
8. Cochez Forcer l'arrêt s'il ne se fait pas à temps seulement si vous acceptez de perdre les données que le système invité n'a pas enregistrées. Sans cette option, la restauration s'arrête et rien ne change.
9. Lisez l'avertissement : « L'agent crée de nouveaux disques pour nom, l'arrête, puis met les nouveaux disques à la place des disques actuels. Les disques actuels sont supprimés quand Proxmox a démarré la VM restaurée. Si la restauration échoue, l'agent remet les disques actuels. »
10. Tapez le nom de l'invité dans le champ de confirmation, exactement comme il apparaît.
11. Cliquez Remplacer la VM ou Remplacer le conteneur.

Le portail refuse la confirmation quand le nom ne correspond pas : « Tapez le nom exactement comme il s'affiche : nom ». L'API et l'agent vérifient ce nom une deuxième fois. Quand l'invité a été renommé entre-temps, le portail écrit « Le nom tapé n'est pas le nom actuel. Tapez-le de nouveau. »

Le remplacement garde la définition de l'invité : son ID Proxmox, son identifiant SMBIOS, ses adresses MAC et son TPM virtuel ne changent pas.

Le mode invité actuel est grisé dans ces cas :

Cas	Texte du portail
L'invité a quitté le nœud	« La VM n'est plus sur le nœud. Restaurez-la comme nouvelle VM. »
L'invité ne peut pas être sauvegardé	« Cette VM ne peut pas être sauvegardée, donc elle ne peut pas être remplacée. »
L'invité a des snapshots Proxmox	« La VM a N snapshots Proxmox. Supprimez-les d'abord. »
L'invité est verrouillé par une autre tâche	« La VM est verrouillée par une autre tâche. Attendez la fin de la tâche. »

Les mêmes textes existent pour un conteneur, au masculin.

Un invité géré par HA

Un invité géré par ha-manager ne peut pas être remplacé : HA le redémarrerait pendant l'opération. Le portail garde le choix ouvert, puis il écrit un bloc avec deux sorties :

1. « Retirez-la ou retirez-le de HA sur le nœud, faites le remplacement, puis remettez-la ou remettez-le dans HA. »
2. « Restaurez-la comme nouvelle VM. », avec le bouton Restaurer comme nouvelle VM.

L'API refuse aussi la demande. Dans la colonne Remarques de l'onglet VM et conteneurs, le portail écrit d'avance : « Gérée par HA : un remplacement est impossible. Une restauration comme nouvelle VM ou nouveau conteneur fonctionne. »

Ce que l'agent fait en cas d'échec

L'agent note la configuration et les volumes de l'invité avant de la changer. Il écrit d'abord les nouveaux disques pendant que l'invité tourne, puis il l'arrête et met les nouveaux disques à la place des anciens.

Quand la restauration échoue :

• l'agent remet les anciennes valeurs sur leurs clés, supprime les nouveaux volumes, et redémarre l'invité s'il tournait. Le portail écrit « La restauration a échoué. L'agent a remis la VM précédente. » ;
• quand ce retour en arrière échoue aussi, aucun volume n'est supprimé. Le portail écrit « La restauration a échoué et l'agent n'a pas pu remettre la VM précédente. Lisez le message de l'agent : il donne les chemins des fichiers. »

Les anciens volumes sont supprimés après le succès seulement. Un disque que le point de restauration ne contient pas reste attaché à l'invité comme disque inutilisé (unusedN), avec l'avertissement « Un disque de la VM précédente est gardé comme disque inutilisé. »

Choisir le stockage

La liste Stockage règle le stockage du nœud pour chaque disque de la VM, ou pour chaque volume du conteneur. Elle donne les stockages actifs du nœud qui acceptent le contenu voulu : images pour une VM, rootdir pour un conteneur. Chaque ligne donne l'identifiant du stockage, son type et son espace libre.

Valeur	Ce qu'elle fait
Même stockage que la source (liste)	Chaque disque ou volume revient sur le stockage qu'il avait à la sauvegarde. Mode nouvel invité.
Stockage actuel de chaque disque	Chaque disque reste sur son stockage actuel. Mode invité actuel.
Un stockage du nœud	Tous les disques ou volumes vont sur ce stockage.

Quand un stockage de la source n'est pas sur le nœud choisi, ou qu'il n'accepte pas ce contenu, le portail écrit « Le stockage liste de la source n'est pas sur ce nœud, ou il n'accepte pas ce contenu. Choisissez un stockage. » Le bouton reste inactif jusqu'à votre choix.

Quand le stockage choisi n'a pas assez de place, le portail écrit « Le stockage id a N libres. La restauration demande environ M. » C'est un avertissement : vous pouvez quand même lancer la restauration. L'agent échoue alors avec Pas assez d'espace libre sur le volume.

La restauration demande la taille des disques, plus 10 %. Pour un conteneur, elle compte les fichiers du point de restauration, plus 10 %.

Choisir le format des disques

Le champ Format des disques n'apparaît que pour une VM, et seulement quand le stockage garde les disques dans des fichiers : un stockage de type dossier, NFS, CIFS, GlusterFS, CephFS ou Btrfs. Le formulaire écrit : « Pour un stockage qui garde les disques dans des fichiers (dossier, NFS). »

Valeur	Ce qu'elle fait
Format par défaut du stockage (qcow2 dans un dossier)	L'agent laisse Proxmox choisir.
qcow2	Disques en qcow2.
raw	Disques en raw.

Sur un stockage par blocs, par exemple LVM-thin, ZFS ou Ceph RBD, le format est toujours raw et le champ n'apparaît pas. Un conteneur n'a pas ce champ : Proxmox choisit le format de ses volumes.

Choisir le bridge réseau

La liste Bridge réseau règle le bridge de chaque carte réseau de l'invité. Elle a trois sortes de valeurs :

Valeur	Ce qu'elle fait
Même bridge que la source, s'il existe	Chaque carte garde le bridge du point de restauration, quand le nœud cible le porte.
Un bridge ou un VNet SDN du nœud	Toutes les cartes vont sur ce bridge.
Déconnecté (link down)	Aucune carte n'est connectée.

Quand le bridge voulu n'existe pas sur le nœud, la restauration réussit avec l'avertissement « Le bridge de la VM n'existe pas sur le nœud. Les cartes réseau sont déconnectées. » Une carte de VM perd alors son bridge et reçoit link_down=1. Une carte de conteneur reçoit le premier bridge du nœud avec link_down=1, parce que Proxmox refuse une carte de conteneur sans bridge.

Dans les deux cas, la carte ne passe aucun trafic : choisissez son bridge dans Proxmox après la restauration, puis retirez link_down.

Choisir les adresses MAC

Le mode nouvel invité offre deux choix.

Choix	Ce qu'il fait
Nouvelles adresses MAC	Pas de conflit avec l'original. Un système invité dont les paramètres réseau suivent l'adresse MAC peut perdre son réseau.
Garder les adresses MAC	Les paramètres réseau du système invité ne changent pas. Deux machines avec la même adresse MAC sur un réseau causent un conflit.

Quand vous gardez les adresses MAC et que l'invité actuel est en marche, le portail écrit « La VM actuelle est en marche. Si la nouvelle VM démarre sur le même réseau avec les mêmes adresses MAC, les deux VM entrent en conflit. »

Le mode invité actuel garde toujours les adresses MAC.

TPM virtuel et BitLocker

Une VM Proxmox peut porter un TPM virtuel. BitLocker dans la VM s'appuie sur ce TPM. BaaStide ne sauvegarde pas le contenu du TPM.

Mode	Texte du portail
Nouvelle VM	« Cette VM a un TPM virtuel. Son contenu n'est pas dans le point de restauration : la nouvelle VM reçoit un nouveau TPM vide. BitLocker dans la VM demande sa clé de récupération au premier démarrage. »
VM actuelle	« Cette VM a un TPM virtuel. La VM garde son TPM actuel : BitLocker s'ouvre souvent sans la clé de récupération. Ce n'est pas sûr : un chargeur de démarrage changé ou un nouveau TPM la demande. »

Dans les deux modes, le portail demande une confirmation : cochez J'ai la clé de récupération BitLocker de cette VM. Le formulaire écrit « Sans cette case cochée, la restauration ne peut pas démarrer. » L'API refuse aussi la demande sans cette confirmation.

Une nouvelle VM reçoit un TPM vide de la même version que celui de la source, sur le stockage de ses disques. La page de suivi porte alors l'avertissement « La VM a un nouveau TPM vide. BitLocker dans la VM demande sa clé de récupération. »

Préparez la clé de récupération BitLocker avant la restauration. Sans elle, le système de la VM restaurée ne démarre pas.

Points particuliers d'un conteneur

Conteneur privilégié

Un conteneur privilégié reste privilégié après la restauration. Le portail écrit « Ce conteneur est privilégié. Il reste privilégié après la restauration : ses processus tournent avec le vrai utilisateur root du nœud. » La page de suivi porte l'avertissement « Le conteneur est privilégié. »

Mappage d'ID personnalisé

Quand le conteneur porte un mappage d'ID personnalisé, le portail écrit « Ce conteneur a un mappage d'ID personnalisé. L'agent le garde seulement si le nœud cible l'autorise. Sinon l'agent le retire, et le conteneur peut ne pas démarrer. »

L'agent compare le mappage aux plages de /etc/subuid et /etc/subgid du nœud cible. Quand le mappage sort de ces plages, il le retire, et la page de suivi porte l'avertissement « Le mappage d'ID personnalisé du conteneur a été retiré. »

Points de montage absents du point de restauration

Un point de montage lié, un périphérique, et un volume avec backup=0 ne sont pas dans le point de restauration. Le portail écrit « Ces points de montage ne sont pas dans le point de restauration : clés. Un remplacement les garde tels quels. Un nouveau conteneur ne les a pas. »

Recréez ces points de montage dans Proxmox après une restauration comme nouveau conteneur.

Adresse IP fixe

Un nouveau conteneur garde l'adresse IP fixe de la source. Quand le conteneur actuel est en marche, le portail écrit « Ce conteneur a une adresse IP fixe et le conteneur actuel est en marche. Le nouveau conteneur a la même adresse : s'il démarre sur le même bridge, les deux conteneurs entrent en conflit. Changez son adresse avant de le démarrer. »

Laissez Démarrer après la restauration décoché dans ce cas.

Restaurer les fichiers d'un conteneur

Les fichiers d'un conteneur ne retournent jamais dans le conteneur. Vous les restaurez dans un dossier du nœud, puis vous les copiez dans le conteneur.

1. Ouvrez l'onglet VM et conteneurs du nœud.
2. Cliquez Fichiers sur la ligne du conteneur. Depuis la page de restauration du conteneur, le bouton Restaurer des fichiers du bloc Fichiers du conteneur ouvre le même assistant.
3. Choisissez le point de restauration, puis les fichiers et les dossiers.
4. Gardez le dossier que le portail propose sur le nœud, ou saisissez un autre dossier.
5. Lancez la restauration.
6. Sur le nœud, copiez les fichiers dans le conteneur, par exemple avec pct push.

Le portail écrit dans le bloc Fichiers du conteneur : « Pour restaurer seulement des fichiers, restaurez-les dans un dossier du nœud. Ils ne vont jamais dans le conteneur : copiez-les ensuite dans le conteneur, par exemple avec pct push. »

Le dossier proposé est /var/lib/baastide-restore/ct-<ID Proxmox>-<AAAAMMJJ-HHMMSS>.

L'emplacement d'origine est refusé : le portail écrit « Impossible pour un conteneur : ses fichiers ne retournent jamais dans le conteneur. Restaurez-les dans un dossier du nœud, puis copiez-les. » L'assistant rappelle aussi : « Fichiers d'un conteneur : ils vont dans un dossier du nœud, avec leurs numéros d'utilisateur et de groupe. Copiez-les dans le conteneur après la restauration. »

Un point de restauration de VM n'a pas de fichiers : l'assistant le refuse. Voir Restaurer des fichiers depuis le portail.

Suivre la restauration

Le portail ouvre la page de la restauration dès l'envoi. Vous y suivez l'avancement et vous pouvez annuler. Voir Suivre et arrêter une restauration.

La carte Machine virtuelle ou Conteneur résume la demande et la réponse de l'agent :

Ligne	Ce qu'elle donne
Restaurer comme	Nouvelle VM, Nouveau conteneur ou Remplacement.
Type	VM ou Conteneur.
VM ou Conteneur	Le nom de l'invité restauré.
Stockage	Le stockage choisi, ou Le même que la source.
Format des disques	Le format choisi, ou Format par défaut du stockage. VM seulement.
Bridge réseau	Le bridge choisi, Même bridge que la source, ou Déconnecté (link down).
Adresses MAC	Gardées ou Nouvelles.
Démarrer après la restauration	Oui ou Non.
ID Proxmox	L'ID de l'invité restauré.
Clé de récupération BitLocker	Confirmée par le technicien, pour une VM avec un TPM.
VM restaurée	La taille restaurée, une fois la restauration terminée.
Paramètres retirés	Les réglages que l'agent n'a pas remis.

Les avertissements

Avertissement	Texte du portail
Paramètres retirés	« Des paramètres de la VM ont été retirés : ils ne sont pas dans la liste des paramètres autorisés. »
TPM remis à zéro	« La VM a un nouveau TPM vide. BitLocker dans la VM demande sa clé de récupération. »
Bridge absent	« Le bridge de la VM n'existe pas sur le nœud. Les cartes réseau sont déconnectées. »
Disque gardé inutilisé	« Un disque de la VM précédente est gardé comme disque inutilisé. »
Conteneur privilégié	« Le conteneur est privilégié. »
Mappage d'ID retiré	« Le mappage d'ID personnalisé du conteneur a été retiré. »

Les paramètres retirés

L'agent remet la configuration de l'invité à partir d'une liste de réglages autorisés. Il retire les réglages qui dépendent du matériel du nœud source, d'un média ou d'un privilège sur le nœud. La carte les nomme :

Nom	Ce qu'il couvre
Code de l'hôte	Un réglage qui fait exécuter du code sur le nœud.
Périphérique pass-through	Un périphérique physique du nœud source.
Réglage du nœud source	Un réglage lié au matériel du nœud source.
Privilège sur l'hôte	Un réglage qui demande un privilège sur le nœud.
Valeur non valide	Une valeur que Proxmox a refusée.
Lecteur cloud-init	Le lecteur cloud-init d'une VM.
Chemin de l'hôte	Un chemin du nœud source.
Réglage inconnu	Une clé que BaaStide ne connaît pas.
Règle de pare-feu inconnue	Une section du pare-feu que BaaStide ne connaît pas.

Vérifiez ces réglages sur l'invité restauré, dans l'interface de Proxmox VE. Un lecteur CD/DVD et le contenu du TPM ne sont jamais remis.

Les causes d'échec

Le portail nomme la cause d'une restauration refusée ou échouée avec ces textes.

Cause	Texte du portail
target_not_proxmox	« La machine n'est pas un nœud Proxmox VE. »
pve_unsupported_version	« La version de Proxmox du nœud est hors support. »
machine_version_unsupported	« Le nœud ne peut pas exécuter la version de machine de la VM. »
target_storage_invalid	« Le stockage n'existe pas sur le nœud ou n'accepte pas ce contenu. »
vm_has_snapshots	« La VM a des snapshots Proxmox. Supprimez-les, puis relancez la restauration. »
vm_ha_managed	« La VM est gérée par HA. Retirez-la de HA, ou restaurez-la comme nouvelle VM. »
vm_busy	« La VM est occupée (verrouillée). Rien n'a changé. »
confirm_name_mismatch	« Le nom tapé n'est pas le nom de la VM. »
vm_not_found	« La VM n'est pas sur l'hôte. »
vm_stop_timeout	« La VM ne s'est pas arrêtée à temps. Rien n'a changé. »
restore_no_space	« Pas assez d'espace libre sur le volume. »
restore_checksum_mismatch	« Un fichier restauré n'est pas identique au fichier sauvegardé. »
restore_config_rejected	« La configuration de la VM a un réglage non autorisé. »
restore_rolled_back	« La restauration a échoué. L'agent a remis la VM précédente. »
rollback_failed	« La restauration a échoué et l'agent n'a pas pu remettre la VM précédente. Lisez le message de l'agent : il donne les chemins des fichiers. »
host_insecure_path	« Un chemin de l'hôte n'est pas sûr. »
read_failed	« Le point de restauration n'a pas pu être lu. »
internal	« Erreur de l'agent. »

Prévisualiser une restauration par l'API ou un assistant IA

Le portail vérifie lui-même le nœud, le stockage et l'espace libre pendant que vous remplissez le formulaire. Une clé API du MSP et un assistant IA utilisent pour cela un aperçu.

L'aperçu ne restaure rien. Il donne :

• les contrôles du nœud cible : hyperviseur, version de Proxmox VE, version de machine, agent en ligne ;
• les totaux : la taille des disques ou des fichiers lus à la sauvegarde, l'espace libre du stockage cible, et si cet espace suffit avec une marge de 10 % ;
• les avertissements, par exemple l'invité source en marche avec les mêmes adresses MAC, ou le conteneur avec une adresse IP fixe.

Pour un assistant IA, l'aperçu donne aussi un jeton de confirmation. Ce jeton sert une seule fois, reste valable 10 minutes, et ne vaut que pour cette demande exacte. Le lancement de la restauration par un assistant IA le demande. Le portail et une clé API du MSP n'en ont pas besoin : l'aperçu reste alors facultatif.

Un assistant IA et une clé API du MSP créent toujours un nouvel invité. Ils ne remplacent jamais un invité : cette action demande une personne connectée au portail. Ils ne restaurent pas non plus une VM qui porte un TPM virtuel.

Limites et précautions

• Le mode invité actuel supprime les disques ou les volumes en place quand la restauration réussit. Préférez le mode nouvel invité quand vous voulez garder l'invité actuel.
• Le remplacement d'un invité se fait dans le portail seulement. Une clé API du MSP et un assistant IA reçoivent 403.
• Un invité géré par HA ne peut pas être remplacé. Retirez-le de HA, ou restaurez-le comme nouvel invité.
• Supprimez les snapshots Proxmox de l'invité avant un remplacement.
• Un invité verrouillé par une autre tâche de Proxmox n'est pas remplacé. Attendez la fin de cette tâche.
• Une restauration Proxmox reste dans le même client. Un nœud d'un autre client est refusé, sans confirmation possible.
• Le nœud cible doit exécuter Proxmox VE 9.0 ou plus récent. Pour une VM, son QEMU doit accepter la version de machine de la VM : restaurez sur un nœud de la même version de Proxmox VE, ou plus récente.
• Le contenu du TPM virtuel n'est jamais restauré. Une nouvelle VM reçoit un TPM vide : préparez la clé de récupération BitLocker avant la restauration.
• Un invité restauré depuis un point cohérent après plantage démarre comme après une coupure de courant. Vérifiez les applications de l'invité.
• Un conteneur privilégié reste privilégié. Ses processus tournent avec le vrai utilisateur root du nœud.
• Un nouveau conteneur n'a pas les points de montage liés, les périphériques et les volumes avec backup=0 de la source. Recréez-les dans Proxmox.
• Un nouveau conteneur garde l'adresse IP fixe de la source. Changez-la avant de le démarrer quand la source tourne.
• Une machine exécute une seule restauration à la fois.
• La restauration demande la taille des disques ou des fichiers, plus 10 %, sur le stockage cible.
• Les réglages liés au matériel du nœud source ne sont pas remis. Relisez la liste Paramètres retirés.
• Une restauration de VM ne donne pas un fichier de la VM. Installez un agent dans la VM pour sauvegarder et restaurer ses fichiers.
• Les fichiers d'un conteneur ne retournent jamais dans le conteneur. Ils vont dans un dossier du nœud.
• Un assistant IA ne restaure pas vers une machine qu'un assistant IA a enrôlée, pendant 24 heures. Voir Choisir la bonne restauration.

Référence

• API : Lister les nœuds d'une restauration de VM.
• API : Prévisualiser une restauration de VM.
• API : Créer une restauration de VM.
• API : Annuler une restauration.
• API : Lister les VM d'un endpoint.
• Outils MCP : preview_vm_restore, start_vm_restore et cancel_vm_restore.
• Outils MCP : list_vm_snapshots et list_vm_restore_targets.