Forzar el apagado de una VM usando la API

Instrucciones paso a paso para forzar el apagado de una VM que no responde usando la API de VergeOS y la interfaz Swagger, incluyendo cómo localizar el ID de la VM, verificar el estado y emitir el comando de apagado.

Resumen

Puntos clave

• Use la API de VergeOS para forzar el apagado de una VM atascada
• Requiere acceso a la API/Swagger
• El proceso implica múltiples llamadas a la API para garantizar una selección precisa del objetivo
• Solo debe usarse cuando fallen los métodos normales de apagado

Esta guía explica cómo forzar el apagado de una máquina virtual (VM) que no responde usando la API de VergeOS cuando los métodos estándar de apagado no tienen éxito.

Requisitos previos

• Acceso a la interfaz de VergeOS con privilegios administrativos
• El nombre de la VM atascada/que no responde
• Comprensión básica de las operaciones de la API

Importante

Este procedimiento solo debe usarse cuando los métodos estándar de apagado hayan fallado. Forzar el apagado de una VM puede provocar pérdida o corrupción de datos si no se usa con cuidado.

Pasos

1. Acceda a la documentación de la API

1. Vaya a Sistema en la interfaz de VergeOS
2. Haga clic en Documentación de la API (también conocido como Swagger)

2. Localice el ID de la VM

1. En la interfaz de la API, localice y expanda la VMs tabla
2. Haga clic en el azul GET botón
3. En la sección de parámetros:

   • Use el filtro name eq your_vm_name para encontrar una VM específica
4. Haga clic en Ejecutar
5. Anote los campos Máquina número de la respuesta

3. Obtenga el ID del estado de la máquina

1. Vaya al machines tabla
2. Haga clic en el azul GEt /machines/{id}
3. En los parámetros:

   • Establezca id en el Número de máquina de la respuesta anterior
   • Establezca fields a status
4. Haga clic en Ejecutar
5. De la respuesta, anote el status valor

4. Verifique el estado de la máquina

1. Vaya a la machine_status tabla
2. Haga clic en el azul GET /machine_stats/{id}
3. En los parámetros:

   • Establezca id a status_number (usando el valor de estado del paso 3)
   • Establezca fields a most
4. Haga clic en Ejecutar
5. Verifique que esta sea la VM correcta comprobando:

   • Número de núcleos
   • Asignación de RAM
   • Información de estado
   • Número de máquina

5. Forzar apagado

1. En el machine_status tabla, haga clic en PUT
2. Ingrese el número de estado como id ID del recurso
3. En el cuerpo de la solicitud, introduzca el siguiente JSON:

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

1. Haga clic en Ejecutar

6. Verifique el apagado

1. Regrese a la interfaz de VergeOS
2. Verifique que la VM aparezca como apagada

Resolución de problemas

Problemas comunes

• Si la VM no aparece como apagada después de la llamada a la API, espere unos minutos para que el estado se actualice
• Si el estado no se actualiza, verifique que todos los ID fueran correctos en los pasos anteriores
• En caso de errores, revise la respuesta de la API para ver mensajes de error específicos

Notas adicionales

• Documente siempre el ID y los valores de estado de la VM antes de realizar cambios
• Considere tomar una instantánea de la VM antes de forzar el apagado si es posible
• Supervise la VM después de forzar el apagado para asegurarse de que se inicie correctamente cuando sea necesario

---

Comentarios

¿Necesitas ayuda?

Si no se siente cómodo con este proceso, póngase en contacto con nuestro equipo de soporte para obtener ayuda.

---

Información del documento

• Última actualización: 2024-01-28
• Versión de VergeOS: Todas