Eine VM über die API zwangsweise ausschalten

Schritt-für-Schritt-Anleitung zum erzwungenen Ausschalten einer nicht reagierenden VM mithilfe der VergeOS-API und der Swagger-Oberfläche, einschließlich des Auffindens der VM-ID, der Statusprüfung und des Ausführens des Ausschaltbefehls.

Überblick

Wichtige Punkte

• Verwenden Sie die VergeOS-API, um eine festgefahrene VM zwangsweise auszuschalten
• Erfordert API-/Swagger-Zugriff
• Der Prozess umfasst mehrere API-Aufrufe, um eine genaue Zielzuweisung sicherzustellen
• Sollte nur verwendet werden, wenn normale Ausschaltmethoden fehlschlagen

Diese Anleitung erklärt, wie Sie eine nicht reagierende virtuelle Maschine (VM) mithilfe der VergeOS-API zwangsweise ausschalten, wenn die Standardmethoden zum Ausschalten erfolglos sind.

Voraussetzungen

• Zugriff auf die VergeOS-Benutzeroberfläche mit Administratorrechten
• Der Name der festgefahrenen/nicht reagierenden VM
• Grundlegendes Verständnis von API-Operationen

Wichtig

Dieses Verfahren sollte nur verwendet werden, wenn die Standardmethoden zum Ausschalten fehlgeschlagen sind. Das erzwungene Ausschalten einer VM kann bei unsachgemäßer Anwendung zu Datenverlust oder -beschädigung führen.

Schritte

1. Greifen Sie auf die API-Dokumentation zu

1. Navigieren Sie zu System in der VergeOS-Benutzeroberfläche
2. Klicken Sie auf API-Dokumentations (auch bekannt als Swagger)

2. Suchen Sie die VM-ID

1. Suchen und erweitern Sie die VMs Tabelle
2. Klicken Sie auf das blaue GET Schaltfläche
3. Im Abschnitt „Parameter“:

   • Verwenden Sie den Filter name eq your_vm_name um eine bestimmte VM zu finden
4. Klicken Sie Ausführen
5. Notieren Sie die Maschine Nummer aus der Antwort

3. Status-ID der Maschine abrufen

1. Navigieren Sie zum machines Tabelle
2. Klicken Sie auf das blaue GEt /machines/{id}
3. In den Parametern:

   • Setzen Sie id bei der Maschinennummer aus der vorherigen Antwort
   • Setzen Sie fields zu status
4. Klicken Sie Ausführen
5. Notieren Sie aus der Antwort den status Wert

4. Maschinenstatus überprüfen

1. Gehen Sie zu der machine_status Tabelle
2. Klicken Sie auf das blaue GET /machine_stats/{id}
3. In den Parametern:

   • Setzen Sie id zu status_number (unter Verwendung des Statuswerts aus Schritt 3)
   • Setzen Sie fields zu meiste
4. Klicken Sie Ausführen
5. Vergewissern Sie sich, dass dies die richtige VM ist, indem Sie Folgendes überprüfen:

   • Anzahl der Kerne
   • RAM-Zuweisung
   • Statusinformationen
   • Maschinennummer

5. Ausschalten erzwingen

1. Im machine_status Tabelle, klicken Sie auf PUT
2. Geben Sie die Statusnummer als id Ressourcen-ID
3. Geben Sie im Request-Body das folgende JSON ein:

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

1. Klicken Sie Ausführen

6. Ausschalten überprüfen

1. Kehren Sie zur VergeOS-Benutzeroberfläche zurück
2. Überprüfen Sie, ob die VM als ausgeschaltet angezeigt wird

Fehlerbehebung

Häufige Probleme

• Wenn die VM nach dem API-Aufruf nicht als ausgeschaltet angezeigt wird, warten Sie ein paar Minuten, bis der Status aktualisiert wird
• Wenn der Status nicht aktualisiert wird, überprüfen Sie, ob in den vorherigen Schritten alle IDs korrekt waren
• Prüfen Sie bei Fehlern die API-Antwort auf spezifische Fehlermeldungen

Zusätzliche Hinweise

• Dokumentieren Sie vor Änderungen immer die ID und die Statuswerte der VM
• Erwägen Sie, vor dem erzwungenen Ausschalten nach Möglichkeit einen Snapshot der VM zu erstellen
• Überwachen Sie die VM nach dem erzwungenen Ausschalten, um sicherzustellen, dass sie bei Bedarf ordnungsgemäß startet

---

Feedback

Brauchen Sie Hilfe?

Wenn Sie sich mit diesem Verfahren nicht wohlfühlen, wenden Sie sich bitte an unser Support-Team, um Hilfe zu erhalten.

---

Dokumentinformationen

• Zuletzt aktualisiert: 2024-01-28
• VergeOS-Version: Alle