Forcer l’arrêt d’une VM via l’API

Instructions étape par étape pour forcer l’arrêt d’une VM non réactive à l’aide de l’API VergeOS et de l’interface Swagger, y compris comment localiser l’ID de la VM, vérifier son état et envoyer la commande d’arrêt.

Vue d’ensemble

Points clés

• Utilisez l'API VergeOS pour forcer l'arrêt d'une VM bloquée
• Nécessite un accès à l'API/Swagger
• Le processus implique plusieurs appels API afin de garantir un ciblage précis
• Ne doit être utilisé que lorsque les méthodes normales d'arrêt échouent

Ce guide explique comment forcer l'arrêt d'une machine virtuelle (VM) non réactive à l'aide de l'API VergeOS lorsque les méthodes d'arrêt standard échouent.

Prérequis

• Accès à l'interface utilisateur VergeOS avec des privilèges administratifs
• Le nom de la VM bloquée/non réactive
• Compréhension de base des opérations API

Important

Cette procédure ne doit être utilisée que lorsque les méthodes d'arrêt standard ont échoué. Forcer l'arrêt d'une VM peut entraîner une perte ou une corruption de données s'il n'est pas utilisé avec précaution.

Étapes

1. Accédez à la documentation de l'API

1. Accédez à Système dans l'interface utilisateur VergeOS
2. Cliquez sur Documentation API (également connu sous le nom de Swagger)

2. Localisez l'ID de la VM

1. Dans l'interface API, localisez et développez le Machines virtuelles tableau
2. Cliquez sur le bleu GET bouton
3. Dans la section des paramètres :

   • Utilisez le filtre name eq votre_nom_de_vm pour trouver une VM spécifique
4. Cliquez Exécuter
5. Notez les champs Machine numéro de la réponse

3. Obtenez l'ID de l'état de la machine

1. Accédez au machines tableau
2. Cliquez sur le bleu GEt /machines/{id}
3. Dans les paramètres :

   • Définir id au Numéro de machine de la réponse précédente
   • Définir champs à status
4. Cliquez Exécuter
5. Dans la réponse, notez la status valeur

4. Vérifiez l'état de la machine

1. Allez à la machine_status tableau
2. Cliquez sur le bleu GET /machine_stats/{id}
3. Dans les paramètres :

   • Définir id à status_number (en utilisant la valeur d'état de l'étape 3)
   • Définir champs à la plupart
4. Cliquez Exécuter
5. Vérifiez qu'il s'agit de la bonne VM en contrôlant :

   • Nombre de cœurs
   • Allocation de RAM
   • Informations d'état
   • Numéro de machine

5. Forcer l'arrêt

1. Dans le machine_status tableau, cliquez PUT
2. Saisissez le numéro d'état comme id identifiant de ressource
3. Dans le corps de la requête, saisissez le JSON suivant :

{
    "running": false,
    "migratable": true,
    "status": "stopped",
    "state": "offline"
}

1. Cliquez Exécuter

6. Vérifiez l'arrêt

1. Retournez à l'interface utilisateur VergeOS
2. Vérifiez que la VM apparaît comme arrêtée

Dépannage

Problèmes courants

• Si la VM n'apparaît pas comme arrêtée après l'appel API, attendez quelques minutes que l'état se mette à jour
• Si l'état ne se met pas à jour, vérifiez que tous les ID étaient corrects dans les étapes précédentes
• En cas d'erreur, consultez la réponse de l'API pour des messages d'erreur spécifiques

Notes supplémentaires

• Documentez toujours l'ID de la VM et les valeurs d'état avant d'apporter des modifications
• Envisagez de prendre un instantané de la VM avant de forcer l'arrêt si possible
• Surveillez la VM après avoir forcé l'arrêt afin de vous assurer qu'elle démarre correctement lorsque nécessaire

---

Retour

Besoin d’aide ?

Si vous ne vous sentez pas à l'aise avec ce processus, veuillez contacter notre équipe d'assistance pour obtenir de l'aide.

---

Informations sur le document

• Dernière mise à jour : 2024-01-28
• Version de VergeOS : Toutes