> 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/api-tables-description.md).

# Description des tables de l’API

Voici une brève description de chacune des tables API. Pour plus de détails, ajoutez **/#swagger** à la fin de l’URL de votre VergeUI (ou accédez à **Système->Documentation API**). Swagger fournit des informations détaillées sur chaque table et vous permet de tester chaque méthode avec une action Get/Post/Put/Delete. Pour plus d’instructions sur l’intégration avec l’API, reportez-vous à la [Documentation API](/knowledge-base/fr/automation-api/verge-api-guide.md) page.

## Tables API

### auth\_source\_states

Fournit une liste des états des sources d’authentification.

### auth\_sources

Table des sources d’autorisation pour gérer des sources d’autorisation comme OpenID ou AzureAD.

### billing

Utilisé pour obtenir les informations de facturation de l’environnement actuel. Celles-ci sont stockées sous forme de données de facturation avec une date de début -> date de fin.

### billing\_actions

Utilisé pour envoyer des actions de facturation. L’action principale est "generate", qui crée une nouvelle facture.

* **Champs :**
  * **action**  : Voir la liste des actions ci-dessous.
* **Actions :**
  * **generate**  : Générer la facture
* **Exemple :**

  ```plaintext
  URL : '/v4/billing_actions'
  POST(JSON) : {"action": "generate"}
  ```

### catalog\_logs

Journaux spécifiques aux catalogues.

### catalog\_repositories

Dépôts de catalogues et sous-listes pour les catalogues, journaux, permissions, etc.

### catalog\_repository\_actions

Utilisé pour envoyer des actions de dépôt de catalogue.

* **Champs :**
  * **repository**  : ID de ligne du dépôt que vous souhaitez actualiser.
  * **action**  : L’action par défaut est refresh. Voir la liste des actions ci-dessous.
* **Actions :**
  * **refresh**  : Actualiser le dépôt de catalogue.
* **Exemple :**

  ```plaintext
  URL : '/v4/catalog_repository_actions'
  POST(JSON) : {"repository": 1, "action": "refresh"}
  ```

### catalog\_repository\_logs

Afficher et publier les journaux du dépôt de catalogue.

### catalog\_repository\_status

Utilisé pour stocker et mettre à jour les statuts du dépôt de catalogue. Ceux-ci déterminent l’état et le statut d’un dépôt de catalogue.

### catalogs

Table des catalogues permettant de mettre à jour, publier ou supprimer des catalogues.

### certificates

Certificats SSL pour votre site.

### clone\_iso

Stocke les informations et l’état du programme Clone ISO de Verge.io.

### clone\_iso\_actions

Actions pour la fonctionnalité Clone ISO.

* **Champs :**
  * **action**  : La valeur par défaut est "update". Voir la liste des actions ci-dessous.
* **Actions :**
  * **update**  : Mettre à jour l’image ISO.
  * **delete**  : Supprimer l’image ISO.
  * **cancel**  : Annuler la génération en cours.
* **Exemple :**

  ```plaintext
  URL : '/v4/clone_iso_actions'
  POST(JSON) : {"action": "update"}
  ```

### cloud\_restore

Stocke les informations lorsqu’une restauration cloud est effectuée.

### cloud\_snapshot\_actions

Actions pour la fonctionnalité d’instantané système.

### cloud\_snapshot\_tenant\_actions

Actions pour la fonctionnalité d’instantané système pour un locataire.

### cloud\_snapshot\_tenants

Instantanés système pour un locataire.

### cloud\_snapshot\_vm\_actions

Actions pour une VM et les instantanés système.

### cloud\_snapshot\_vms

Utilisé pour stocker des informations lorsqu’un instantané système est téléchargé vers une VM.

### cloud\_snapshots

La table des instantanés système comprend des informations sur l’instantané système, ainsi qu’une liste de VM, de locataires et de files de synchronisation. Cela peut être utilisé pour voir quelles VM sont incluses dans un instantané système.

### cloudinit\_files

Opérations pour la fonctionnalité Cloudinit Files.

### cluster\_actions

Cluster Actions est utilisé pour envoyer des actions pour les clusters.

* **Champs :**
  * **cluster**  : ID de ligne du cluster (obligatoire).
  * **action**  : Voir la liste des actions ci-dessous.
  * **params**  : Paramètres fournis au format JSON (facultatif).
* **Actions :**
  * **shutdown**  : Arrêter le cluster.
  * **cancel\_shutdown**  : Annuler la demande d’arrêt en cours.
* **Exemple :**

  ```plaintext
  URL : '/v4/cluster_actions'
  POST(JSON) : {"cluster": 1, "action": "shutdown", "params": "{}"}
  ```

### cluster\_stats\_history\_long

La table cluster\_stats\_history\_long conserve l’historique des statistiques du cluster sur de longues périodes.

### cluster\_stats\_history\_short

La table cluster\_stats\_history\_short conserve les statistiques du cluster sur une courte période, en stockant les statistiques les plus récentes pour un accès rapide.

### cluster\_status

Gère l’état de tous les clusters.

### cluster\_tier\_stats

Gère les statistiques des niveaux vSAN d’un cluster.

### cluster\_tier\_stats\_history\_long

Conserve des statistiques historiques pour les niveaux de cluster sur de longues périodes.

### cluster\_tier\_stats\_history\_short

Conserve des statistiques historiques pour les niveaux de cluster sur de courtes périodes, en stockant les statistiques les plus récentes pour un accès rapide.

### cluster\_tier\_status

Utilisé pour les statuts des niveaux de cluster.

### cluster\_tiers

Conserve une liste des niveaux pour le cluster.

### clusters

La table principale des données sur les clusters.

### file\_actions

La table file\_actions envoie des actions sur les fichiers.

* **Champs :**
  * **file**  : ID du fichier de la table files (obligatoire).
  * **action**  : Voir la liste des actions ci-dessous.
  * **params**  : Paramètres fournis au format JSON (facultatif).
* **Actions :**
  * **overwrite**  : Écraser le fichier.
  * **add\_link**  : Ajouter un lien de fichier.
  * **delete\_link**  : Supprimer un lien de fichier.
  * **delete\_reference**  : Supprimer les références du fichier.
* **Exemple :**

  ```plaintext
  URL : '/v4/file_actions'
  POST(JSON) : {"file": 1, "action": "add_link", "params": "{}"}
  ```

### files

Informations liées aux fichiers stockés.

### files\_public\_links

Gère les liens publics pour les fichiers.

### group\_logs

Journaux liés aux groupes.

### groups

Table de gestion des groupes.

### help\_actions

Gère les actions liées à l’aide.

### help\_search

Table de recherche pour la documentation d’aide.

### licenses

Gère les licences VergeOS.

### logs

Gère les journaux système.

### machine\_console

Gère les interactions de la console machine.

### machine\_console\_active

Suit les sessions de console machine actives.

### machine\_console\_active\_chat

Suit les interactions de chat dans les consoles machine actives.

### machine\_device\_gpu\_stats\_history\_long

Conserve des statistiques historiques du GPU sur de longues périodes.

### machine\_device\_gpu\_stats\_history\_short

Conserve des statistiques historiques du GPU sur de courtes périodes.

### machine\_device\_settings\_nvidia\_vgpu

Gère les paramètres des périphériques Nvidia vGPU.

### machine\_device\_settings\_tpm

Gère les paramètres des périphériques TPM.

### machine\_device\_stats

Suit les statistiques des périphériques.

### machine\_device\_status

Suit l’état des périphériques.

### machine\_devices

Table des informations sur les périphériques des machines.

### machine\_drive\_phys

Données des disques physiques pour les machines.

### machine\_drive\_stats

Statistiques des disques pour les machines.

### machine\_drive\_stats\_history\_long

Conserve des statistiques historiques des disques sur de longues périodes.

### machine\_drive\_stats\_history\_short

Conserve des statistiques historiques des disques sur de courtes périodes.

### machine\_drive\_status

Suit l’état des disques pour les machines.

### machine\_drives

Table des disques des machines.

### machine\_logs

Suit les journaux des machines.

### machine\_nic\_stats

Statistiques NIC pour les machines.

### machine\_nic\_stats\_history\_long

Statistiques historiques NIC sur de longues périodes.

### machine\_nic\_stats\_history\_short

Statistiques historiques NIC sur de courtes périodes.

### machine\_nic\_status

État des NIC pour les machines.

### machine\_nics

Table des NIC dans les machines.

### machine\_snapshots

Suit les instantanés des machines.

### machine\_stats

Statistiques générales des machines.

### machine\_stats\_history\_long

Statistiques historiques des machines sur de longues périodes.

### machine\_stats\_history\_short

Statistiques historiques des machines sur de courtes périodes.

### machine\_status

Suit l’état des machines.

### machines

Table principale des données des machines.

***

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

* Dernière mise à jour : 2024-08-29
* Version de vergeOS : 4.12.6
  {% 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/api-tables-description.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.
