Référence Pour: administrateurs, utilisateurs

Erreurs d'opérations d'invité

Causes et solutions des codes d'erreur des opérations d'invité sur les fichiers et programmes d'une machine virtuelle.

error.guest_operations_unavailable

Texte dans la console
Les opérations invité ne sont pas disponibles : la machine virtuelle est arrêtée, n’a pas d’agent invité, ou l’agent bloque la commande.
Signification pour les clients de l'API
Guest operations are not available (powered off, no agent, or agent blocks the command).
Code
FAILED_PRECONDITION, HTTP 412

Cause. L'agent invité ne peut pas exécuter l'opération. Soit la machine virtuelle est hors tension, soit elle n'a pas d'agent invité ou l'agent ne répond pas, soit l'agent est configuré pour refuser ce type d'opération (programmes ou fichiers). Le message de la réponse de l'API contient le motif signalé par l'agent.

Solution.

  1. Mettez la machine virtuelle sous tension si elle est hors tension : kyvernon vm power-on <id>.
  2. Vérifiez que l'agent invité s'exécute dans l'invité. Installez-le ou redémarrez-le s'il ne s'exécute pas. kyvernon vm guest validate <id> --username <user> teste si les opérations d'invité sont disponibles.
  3. Si l'agent bloque l'opération, un administrateur de la machine virtuelle modifie son accès invité avec Modifier l’accès invité.
  4. Transmettez le motif de la réponse si la cause reste peu claire.

error.guest_file_exists

Texte dans la console
Le fichier existe déjà dans l’invité. Choisissez d’écraser pour le remplacer.
Signification pour les clients de l'API
The file already exists in the guest (use overwrite).
Code
ALREADY_EXISTS, HTTP 409

Cause. Le fichier existe déjà dans l'invité, et l'opération n'écrase pas.

Solution.

  1. Choisissez un autre nom de fichier.
  2. Pour remplacer le fichier volontairement, écrivez-le à nouveau en autorisant l'écrasement. Avec la CLI, kyvernon vm guest write-file écrase sauf si --no-overwrite est donné, et kyvernon vm guest move-file <id> --src <path> --dst <path> --overwrite remplace la destination.

error.guest_path_not_found

Texte dans la console
Le chemin n’existe pas dans l’invité.
Signification pour les clients de l'API
The path does not exist in the guest.
Code
NOT_FOUND, HTTP 404

Cause. Le chemin n'existe pas dans l'invité, ou un dossier sur le chemin n'existe pas.

Solution.

  1. Listez le dossier parent dans l'invité : kyvernon vm guest list-files <id> --path <folder>.
  2. Utilisez un chemin tel que l'invité l'écrit. Les chemins suivent le système d'exploitation de l'invité.
  3. Créez d'abord le dossier manquant : kyvernon vm guest mkdir <id> --path <folder> --parents.

error.guest_path_is_directory

Texte dans la console
Le chemin est un dossier dans l’invité.
Signification pour les clients de l'API
The path is a directory in the guest.
Code
INVALID_ARGUMENT, HTTP 400

Cause. Le chemin est un dossier dans l'invité, et l'opération ne porte que sur des fichiers, par exemple lire ou supprimer un fichier.

Solution.

  1. Donnez le chemin d'un fichier.
  2. Pour supprimer un dossier, utilisez kyvernon vm guest rmdir <id> --path <folder>. Pour déplacer un dossier, utilisez kyvernon vm guest move-dir.

error.guest_path_not_directory

Texte dans la console
Le chemin n’est pas un dossier dans l’invité.
Signification pour les clients de l'API
The path is not a directory in the guest.
Code
INVALID_ARGUMENT, HTTP 400

Cause. Le chemin est un fichier dans l'invité, et l'opération ne porte que sur des dossiers, par exemple lister ou créer des fichiers en dessous.

Solution.

  1. Donnez le chemin d'un dossier.
  2. Pour travailler sur le fichier lui-même, utilisez l'opération pour les fichiers, par exemple kyvernon vm guest read-file <id> --path <file>.

error.guest_directory_not_empty

Texte dans la console
Le dossier de l’invité n’est pas vide.
Signification pour les clients de l'API
The directory is not empty in the guest.
Code
FAILED_PRECONDITION, HTTP 412

Cause. Le dossier de l'invité contient encore des fichiers, et l'opération ne supprime pas de façon récursive.

Solution.

  1. Supprimez d'abord le contenu, ou supprimez le dossier avec son contenu : kyvernon vm guest rmdir <id> --path <folder> --recursive.
  2. Vérifiez le contenu avant une suppression récursive. L'opération est irréversible.

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