Référence Pour: administrateurs, utilisateurs, locataires

Erreurs de console

Causes et solutions des codes d'erreur renvoyés lors de l'émission ou de l'utilisation d'un ticket de console.

error.console.powered_off

Texte dans la console
La machine virtuelle est hors tension.
Signification pour les clients de l'API
The VM is powered off; a console needs a running VM.
Code
FAILED_PRECONDITION, HTTP 412

Cause. Un ticket de console a été demandé pour une machine virtuelle qui n'est ni sous tension ni suspendue. Une console exige une machine virtuelle en cours d'exécution.

Solution.

  1. Mettez la machine virtuelle sous tension : kyvernon vm power-on <id>. Dans la console, utilisez Mettre sous tension.
  2. Ouvrez à nouveau la console avec Ouvrir la console.

error.console.not_available

Texte dans la console
Cette machine virtuelle n’a pas de console graphique.
Signification pour les clients de l'API
The VM runs without a graphical console (no console.vnc).
Code
FAILED_PRECONDITION, HTTP 412

Cause. L'agent d'hôte a signalé que la machine virtuelle s'exécute sans console graphique, par exemple parce qu'elle utilise un runtime sans affichage VNC.

Solution.

  1. Utilisez la console série à la place : kyvernon vm serial-log <id> affiche la fin du journal série. Dans la console, utilisez Journal série.
  2. Si une console graphique est nécessaire, un administrateur change le runtime de la machine virtuelle. Transmettez-lui l'identifiant de message error.console.not_available et le nom de la machine virtuelle.

error.console.host_disconnected

Texte dans la console
L’hôte de la machine virtuelle n’est pas connecté.
Signification pour les clients de l'API
The VM's host is not connected.
Code
UNAVAILABLE, HTTP 503

Cause. L'hôte qui exécute la machine virtuelle n'est pas connecté au contrôleur ; la console est donc inaccessible.

Solution.

  1. Vérifiez l'état de l'hôte dans l'inventaire, puis réessayez lorsqu'il est connecté.
  2. Un administrateur vérifie l'hôte et son agent. Un hôte déconnecté volontairement reste déconnecté tant que kyvernon host reconnect <id> n'a pas été exécuté. Transmettez-lui le nom de la machine virtuelle et l'heure de l'erreur.

error.console.rate_limited

Texte dans la console
Trop de tickets de console. Réessayez dans {retryAfterSeconds} secondes.
Signification pour les clients de l'API
Too many console tickets for this session.
Code
RESOURCE_EXHAUSTED, HTTP 429
ArgumentContenu
retryAfterSecondsles secondes à attendre avant l'émission d'un nouveau ticket.

Cause. La session a demandé plus de 20 tickets de console en une minute. Kyvernon limite les tickets par session.

Solution.

  1. Attendez le nombre de secondes indiqué dans le message.
  2. Réutilisez la console ouverte au lieu d'en ouvrir une nouvelle à chaque fois. Un ticket est valable 30 secondes et ne sert qu'une fois.

error.console.ticket_invalid

Texte dans la console
Le ticket de console est invalide, déjà utilisé ou expiré.
Signification pour les clients de l'API
The console ticket is unknown, used or expired.
Code
UNAUTHENTICATED, HTTP 401

Cause. Le ticket de console est inconnu, a déjà été utilisé ou date de plus de 30 secondes. Un ticket ne sert qu'une fois et seulement pour la session qui l'a demandé.

Solution.

  1. Demandez un nouveau ticket et connectez-vous aussitôt : kyvernon vm console ticket <id>. Dans la console, utilisez à nouveau Ouvrir la console.
  2. Ne conservez pas et ne partagez pas les tickets. Chaque nouvelle connexion exige un nouveau ticket.

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