Référence Pour: administrateurs

Erreurs d'hôte

Causes et solutions des codes d'erreur des hôtes : mémoire, capacités, mode maintenance et suppression.

error.host.insufficient_memory

Texte dans la console
L’hôte {host} a {available} Mio de mémoire libres pour les machines virtuelles ; celle-ci a besoin de {requested} Mio. Arrêtez d’autres machines virtuelles, donnez-lui moins de mémoire ou déplacez-la vers un autre hôte.
Signification pour les clients de l'API
Power-on refused: the host has available MiB free for virtual machines, the guest needs requested.
Code
FAILED_PRECONDITION, HTTP 412
ArgumentContenu
requestedla mémoire en Mio dont la machine virtuelle a besoin.
availablela mémoire en Mio que l'hôte a de libre pour les machines virtuelles.
hostle nom de l'hôte.

Cause. La mise sous tension a été refusée, car l'hôte a moins de mémoire libre pour les machines virtuelles que la machine virtuelle n'en demande. La mémoire libre est la mémoire de l'hôte, moins la réserve que l'hôte garde pour lui-même (host_memory_reserve_mib dans la section [vm_ops], 2048 Mio par défaut), moins la mémoire des machines virtuelles qui s'y exécutent. Le paramètre memory_overcommit_ratio de la même section permet aux machines virtuelles en cours d'exécution de dépasser ce montant ; sa valeur par défaut de 1.0 signifie aucune surallocation.

Solution.

  1. Mettez hors tension les machines virtuelles inutiles sur cet hôte : kyvernon vm power-off <id>.
  2. Donnez moins de mémoire à la machine virtuelle : Modifier les paramètres.
  3. Déplacez la machine virtuelle vers un hôte avec plus de mémoire libre : kyvernon vm relocate <id> --host <host>.

error.host.not_in_maintenance

Texte dans la console
L'hôte {host} n'est pas en mode maintenance. Passez-le d'abord en mode maintenance, ou forcez le redémarrage ou l'arrêt.
Signification pour les clients de l'API
Reboot or shutdown needs the host in maintenance mode (or force).
Code
FAILED_PRECONDITION, HTTP 412
ArgumentContenu
hostle nom de l'hôte.

Cause. Un redémarrage ou un arrêt de l'hôte a été demandé alors que l'hôte n'est pas en mode maintenance. Un hôte en mode maintenance n'exécute aucune machine virtuelle, donc rien ne s'arrête avec lui.

Solution.

  1. Passez d'abord en mode maintenance : kyvernon host enter-maintenance <id> --wait. Dans la console, utilisez Passer en mode maintenance.
  2. Redémarrez ensuite : kyvernon host reboot <id>, ou arrêtez : kyvernon host shutdown <id>. Dans la console, utilisez Redémarrer.
  3. Si les machines virtuelles de l'hôte peuvent s'arrêter avec lui, forcez l'action : kyvernon host reboot <id> --force.

error.host.not_connected

Texte dans la console
L'hôte {host} n'est pas connecté au plan de contrôle. Réessayez lorsqu'il est de nouveau connecté.
Signification pour les clients de l'API
The host is not connected to the control plane.
Code
UNAVAILABLE, HTTP 503
ArgumentContenu
hostle nom de l'hôte.

Cause. L'opération a besoin de l'agent de l'hôte, et l'hôte n'est pas connecté au plan de contrôle : un administrateur l'a déconnecté, il ne répond pas, ou son agent ne s'est pas encore enregistré.

Solution.

  1. Consultez l'état de connexion de l'hôte : kyvernon inventory host <id>.
  2. Un hôte déconnecté par un administrateur revient avec kyvernon host reconnect <id>.
  3. Un hôte qui ne répond pas a besoin de son agent en marche et du réseau vers le contrôleur : vérifiez le service kyvernon-agent sur l'hôte.

error.host_capability_missing

Texte dans la console
L’hôte ne propose pas la capacité {capability}. Choisissez un autre hôte ou mettez à jour l’agent d’hôte.
Signification pour les clients de l'API
The host did not declare the needed capability.
Code
UNIMPLEMENTED, HTTP 501
ArgumentContenu
capabilityla capacité qui manque à l'hôte.

Cause. L'opération exige une capacité que l'hôte n'a pas déclarée. Suspendre une machine virtuelle exige suspend-to-disk, modifier les vCPU, la mémoire ou les périphériques d'une machine virtuelle en cours d'exécution exige hotplug, et la migration à chaud exige live-migration sur les deux hôtes.

Solution.

  1. Choisissez un hôte qui offre la capacité. Les capacités d'un hôte figurent dans son enregistrement : kyvernon inventory host <id>.
  2. Mettez à niveau l'agent d'hôte vers une version qui déclare la capacité, puis reconnectez l'hôte.
  3. Pour une modification des vCPU, de la mémoire ou des périphériques, mettez d'abord la machine virtuelle hors tension.

error.host_has_running_vms

Texte dans la console
L’hôte exécute encore des VM en cours d’exécution ou suspendues. Mettez-les hors tension ou évacuez-les d’abord.
Signification pour les clients de l'API
Maintenance mode needs the host's VMs powered off or moved.
Code
FAILED_PRECONDITION, HTTP 412

Cause. L'hôte ne peut pas passer en mode maintenance tant que des machines virtuelles s'y exécutent ou y sont suspendues.

Solution.

  1. Déplacez les machines virtuelles vers un autre hôte avec Migrer, ou mettez-les hors tension.
  2. Passez à nouveau en mode maintenance : kyvernon host enter-maintenance <id>. Dans la console, utilisez Passer en mode maintenance.

error.host_has_vms

Texte dans la console
L’hôte a encore des VM ; déplacez-les ou détruisez-les d’abord
Signification pour les clients de l'API
The host still has VMs placed on it; relocate or destroy them first.
Code
FAILED_PRECONDITION, HTTP 412

Cause. Un hôte sur lequel des machines virtuelles sont placées ne peut pas être supprimé. Cela inclut les machines virtuelles hors tension.

Solution.

  1. Déplacez chaque machine virtuelle vers un autre hôte : kyvernon vm relocate <id> --host <host>. Les machines virtuelles devenues inutiles peuvent être supprimées.
  2. Supprimez l'hôte : kyvernon host destroy <id>. Dans la console, utilisez Supprimer l’hôte.

error.host_in_maintenance

Texte dans la console
L’hôte est en mode maintenance.
Signification pour les clients de l'API
The host is in maintenance mode.
Code
FAILED_PRECONDITION, HTTP 412

Cause. L'opération place une machine virtuelle sur un hôte en mode maintenance. Un hôte en mode maintenance ne reçoit aucune nouvelle machine virtuelle.

Solution.

  1. Choisissez un autre hôte.
  2. Ou mettez fin au mode maintenance : kyvernon host exit-maintenance <id>. Dans la console, utilisez Quitter le mode maintenance.

Version 0.1. Dernière modification : 2026-11-13