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

Erreurs de machine virtuelle

Causes et solutions des codes d'erreur des opérations d'alimentation, du placement, des limites de configuration et des instantanés.

error.invalid_power_state

Texte dans la console
L’opération est impossible lorsque la machine virtuelle est {power_state, select, powered_on {sous tension} PoweredOn {sous tension} poweredon {sous tension} powered_off {hors tension} PoweredOff {hors tension} poweredoff {hors tension} suspended {suspendue} Suspended {suspendue} paused {en pause} Paused {en pause} other {dans cet état d’alimentation}}. {required, select, powered_off {Mettez d’abord la machine virtuelle hors tension} powered_on {Mettez d’abord la machine virtuelle sous tension} suspended {Suspendez d’abord la machine virtuelle} other {Modifiez d’abord l’état d’alimentation}}, puis réessayez.
Signification pour les clients de l'API
The operation needs another power state: power_state is the current one, required the one it needs (powered_off, powered_on or suspended).
Code
FAILED_PRECONDITION, HTTP 412
ArgumentContenu
power_statel'état d'alimentation actuel, par exemple poweredon ou poweredoff.
requiredl'état d'alimentation exigé par l'opération : powered_off, powered_on ou suspended.

Cause. L'opération n'est pas possible dans l'état d'alimentation actuel de la machine virtuelle. L'argument required nomme l'état exigé : powered_off pour le retrait de l'inventaire, la conversion en modèle, la personnalisation, la suppression, le déplacement du stockage et le clonage ; powered_on pour la réinitialisation et la suspension. Pour la mise sous tension, c'est powered_off, et pour la mise hors tension powered_on, bien qu'une machine virtuelle suspendue ou en pause convienne aussi pour les deux.

Solution.

  1. Vérifiez l'état d'alimentation dans l'inventaire : kyvernon inventory vm <id>.
  2. Amenez la machine virtuelle à l'état indiqué par required, par exemple Mettre hors tension ou kyvernon vm power-off <id>, puis répétez l'opération.
  3. Si l'état change de lui-même, attendez la fin de la tâche qui s'exécute sur la machine virtuelle : kyvernon tasks list --target <id>.

error.vm_not_placed

Texte dans la console
La machine virtuelle n’est pas placée sur un hôte. {reason, select, no_connected_host {Aucun hôte de son cluster n’est connecté. Rétablissez la connexion d’un hôte, puis déplacez-y la machine virtuelle.} all_in_maintenance {Tous les hôtes connectés de son cluster sont en mode maintenance. Quittez le mode maintenance d’un hôte, puis déplacez-y la machine virtuelle.} no_hosts {Son cluster ne contient aucun hôte. Ajoutez un hôte au cluster, puis déplacez-y la machine virtuelle.} no_compute_resource {Son groupe de ressources n’appartient ni à un cluster ni à un hôte autonome. Déplacez la machine virtuelle vers un groupe de ressources d’un cluster ou d’un hôte.} other {Aucun hôte ne lui est attribué. Déplacez la machine virtuelle vers un hôte.}}
Signification pour les clients de l'API
The VM has no host. reason is no_connected_host, all_in_maintenance, no_hosts, no_compute_resource (placement finds no host today) or not_assigned (a host is available but the VM names none).
Code
FAILED_PRECONDITION, HTTP 412
ArgumentContenu
reasonno_connected_host, all_in_maintenance, no_hosts, no_compute_resource ou not_assigned.

Cause. La machine virtuelle n'a pas d'hôte. L'argument reason indique ce que le placement trouve aujourd'hui :

  • no_connected_host : les hôtes de son cluster existent, mais aucun n'est connecté.
  • all_in_maintenance : tous les hôtes connectés de son cluster sont en mode maintenance.
  • no_hosts : son cluster ne contient aucun hôte.
  • no_compute_resource : son groupe de ressources n'appartient ni à un cluster ni à un hôte autonome.
  • not_assigned : un hôte est disponible, mais l'enregistrement de la machine virtuelle n'en nomme aucun.

Le placement ne tient compte que de la connexion et du mode maintenance. La mémoire libre est vérifiée lors de la mise sous tension. La mise sous tension ne place pas une machine virtuelle qui n'a pas d'hôte. Les opérations qui atteignent la machine en cours d'exécution, telles que la console, les opérations invité et la vérification, exigent un hôte.

Solution.

  1. Lisez la raison dans le message et corrigez-la : reconnectez un hôte avec kyvernon host reconnect <id> (no_connected_host), quittez le mode maintenance d'un hôte avec kyvernon host exit-maintenance <id> (all_in_maintenance), ajoutez un hôte au cluster (no_hosts) ou déplacez la machine virtuelle vers un groupe de ressources d'un cluster ou d'un hôte (no_compute_resource).
  2. Placez la machine virtuelle sur un hôte : kyvernon vm relocate <id> --host <host>.
  3. Répétez l'opération. Si la raison persiste, communiquez à un administrateur le nom de la machine virtuelle et la raison.

error.vm_spec_unbuildable

Texte dans la console
La configuration de la machine virtuelle ne peut pas être construite sur son hôte. Vérifiez les paramètres matériels et les capacités de l’hôte. Les détails de la tâche indiquent la cause.
Signification pour les clients de l'API
The VM configuration cannot be built on the host; the message names the cause.
Code
FAILED_PRECONDITION, HTTP 412

Cause. La configuration de la machine virtuelle ne peut pas être transformée en machine sur l'hôte. Le message de la réponse de l'API et les détails de la tâche en échec donnent le motif signalé par l'hôte : un périphérique ou un réglage que l'hôte ne prend pas en charge. L'erreur ne porte aucun argument pour la cause.

Solution.

  1. Trouvez la cause : lisez le message de la réponse ou ouvrez les détails de la tâche en échec : kyvernon tasks list --target <id>. Le journal du contrôleur la contient aussi.
  2. Vérifiez les réglages matériels qu'elle nomme : Modifier les paramètres.
  3. Supprimez ou modifiez le périphérique ou le réglage.
  4. Si l'hôte est en cause, choisissez un autre hôte : kyvernon vm relocate <id> --host <host>.

error.vm.concurrent_modification

Texte dans la console
La configuration de la machine virtuelle a changé pendant que vous la modifiiez. Rechargez la machine virtuelle et refaites la modification.
Signification pour les clients de l'API
The VM configuration changed since the request's change_version was read and the change cannot be merged; read the VM again and repeat (HTTP 409).
Code
CONFLICT, HTTP 409

Cause. La configuration de la machine virtuelle a changé après votre lecture, et votre modification ne peut pas être fusionnée avec l'autre. La requête porte le change_version que vous avez lu, et il n'est plus à jour.

Solution.

  1. Relisez la machine virtuelle : rechargez-la dans la console, ou exécutez kyvernon inventory vm <id>.
  2. Refaites la modification sur la configuration actuelle : kyvernon vm reconfigure <id> --config <file>.

error.vm.exceeds_host_cpu

Texte dans la console
{requested} vCPU dépassent les {limit} que l’hôte {host} autorise pour une machine virtuelle. Choisissez moins de vCPU.
Signification pour les clients de l'API
More vCPUs than the host has logical CPUs (or than vm_ops.max_vcpus_per_vm).
Code
INVALID_ARGUMENT, HTTP 400
ArgumentContenu
fieldle champ de la requête qui contient la valeur refusée, ici config.num_cpus.
requestedle nombre de vCPU demandé.
limitle plus grand nombre autorisé.
hostle nom de l'hôte.

Cause. Le nombre de vCPU est supérieur au nombre de processeurs logiques de l'hôte, ou supérieur à la limite max_vcpus_per_vm de la section [vm_ops] de la configuration du contrôleur. Quand ce réglage vaut 0, les processeurs logiques de l'hôte constituent la limite.

Solution.

  1. Choisissez moins de vCPU : Modifier les paramètres.
  2. Ou placez la machine virtuelle sur un hôte qui a plus de processeurs logiques.
  3. Un administrateur peut augmenter max_vcpus_per_vm. Communiquez l'identifiant de message et le nombre dont vous avez besoin.

error.vm.exceeds_host_memory

Texte dans la console
{requested} Mio de mémoire dépassent les {limit} Mio que l’hôte {host} peut donner à une machine virtuelle. Choisissez moins de mémoire.
Signification pour les clients de l'API
More memory (MiB) than the host has after vm_ops.host_memory_reserve_mib.
Code
INVALID_ARGUMENT, HTTP 400
ArgumentContenu
fieldle champ de la requête qui contient la valeur refusée, ici config.memory_mib.
requestedla mémoire demandée, en Mio.
limitla plus grande quantité autorisée, en Mio.
hostle nom de l'hôte.

Cause. La mémoire est supérieure à ce que l'hôte peut donner à une machine virtuelle : la mémoire de l'hôte moins la réserve qu'il garde pour lui-même. La réserve est host_memory_reserve_mib dans la section [vm_ops] de la configuration du contrôleur (2048 Mio par défaut).

Solution.

  1. Choisissez moins de mémoire : Modifier les paramètres.
  2. Ou placez la machine virtuelle sur un hôte qui a plus de mémoire.
  3. Un administrateur peut diminuer host_memory_reserve_mib. Communiquez l'identifiant de message et la quantité dont vous avez besoin.

error.vm.too_many_devices

Texte dans la console
Une machine virtuelle peut avoir au plus {limit} {device, select, cdroms {lecteurs de CD-ROM} other {disques et cartes réseau au total}} ; cette configuration en a {count}. Retirez d’abord des périphériques.
Signification pour les clients de l'API
More disks and network adapters together (device = disks_and_nics), or CD-ROM drives (cdroms), than a virtual machine has slots.
Code
INVALID_ARGUMENT, HTTP 400
ArgumentContenu
devicedisks_and_nics ou cdroms.
countle nombre de périphériques dans la configuration.
limitle plus grand nombre autorisé.

Cause. La configuration compte plus de périphériques qu'une machine virtuelle n'a d'emplacements. Les disques et les cartes réseau partagent une même limite, et les lecteurs de CD-ROM ont la leur. Une configuration qui dépasse déjà la limite peut encore être modifiée, tant qu'elle ne grandit pas.

Solution.

  1. Supprimez les périphériques inutiles : Modifier les paramètres.
  2. Répétez la modification.

error.no_current_snapshot

Texte dans la console
La machine virtuelle n’a pas d’instantané actuel à restaurer. Prenez d’abord un instantané.
Signification pour les clients de l'API
The VM has no current snapshot to revert to.
Code
NOT_FOUND, HTTP 404

Cause. La restauration de l'instantané courant a été demandée, mais la machine virtuelle n'a pas d'instantané courant.

Solution.

  1. Listez les instantanés et restaurez un instantané nommé : kyvernon vm snapshot revert <id> <key>.
  2. Pour pouvoir restaurer à l'avenir, créez d'abord un instantané : kyvernon vm snapshot create <id> --name <name>. Dans la console, utilisez Instantanés.

error.template_relocate

Texte dans la console
Les modèles ne peuvent pas être déplacés.
Signification pour les clients de l'API
Templates cannot be relocated.
Code
FAILED_PRECONDITION, HTTP 412

Cause. Le modèle devait être déplacé vers un autre hôte ou datastore. Les modèles ne peuvent pas être déplacés.

Solution.

  1. Convertissez le modèle en machine virtuelle, déplacez-la, puis reconvertissez-la : kyvernon vm mark-as-vm <id>, kyvernon vm relocate <id> --datastore <datastore>, kyvernon vm mark-as-template <id>.
  2. Ou clonez le modèle vers la destination : kyvernon vm clone <id> --name <name> --datastore <datastore> --template.

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