> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/knowledge-base/es/automation-api/force-power-off-vm-using-api.md).

# Forzar el apagado de una VM usando la API

## Resumen

{% hint style="info" %}
**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
  {% endhint %}

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

{% hint style="warning" %}
**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.
{% endhint %}

## 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:

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

4. 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

{% hint style="warning" %}
**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
  {% endhint %}

## 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

{% hint style="info" %}
**¿Necesitas ayuda?**

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

***

{% hint style="info" %}
**Información del documento**

* Última actualización: 2024-01-28
* Versión de VergeOS: Todas
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/knowledge-base/es/automation-api/force-power-off-vm-using-api.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.