> 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/fr/automation-api/force-power-off-vm-using-api.md).

# Forcer l’arrêt d’une VM à l’aide de l’API

## Vue d’ensemble

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

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

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

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

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

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

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

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

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

***

{% hint style="info" %}
**Informations sur le document**

* Dernière mise à jour : 2024-01-28
* Version de VergeOS : Toutes
  {% 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/fr/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.