> For the complete documentation index, see [llms.txt](https://docs.plenit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.plenit.com/fr/reference/servers-api/disk/listdisks.md).

# Cas d’usage

* **Inventorier tous les disques d’un abonnement** Appelez ce point de terminaison pour obtenir une vue complète de chaque disque — disques racine, disques de données et volumes non attachés — au sein d’un abonnement. Utilisez le `type` et `état` champs de la réponse pour catégoriser et auditer vos ressources de stockage.
* **Trouver les disques non attachés disponibles pour réutilisation** Filtrez la réponse en recherchant les disques dont `serverId` est `null`. Ce sont des disques actuellement non attachés à aucun serveur et ils peuvent être attachés à un nouveau serveur ou à un serveur existant à l’aide du [Attacher un disque au serveur](https://gitlab.com/plenit-group/plenit-docs-es-es/-/blob/v1.0/reference/diskattachtoserver/README.md) point de terminaison, évitant ainsi la création inutile de disques.
* **Surveiller l’état et la capacité des disques** Interrogez périodiquement ce point de terminaison pour suivre les états des disques (par ex., `Prêt`, approvisionnement) et les tailles dans toute votre infrastructure. Créez des alertes ou des tableaux de bord qui signalent les disques approchant des limites de capacité ou bloqués dans des états inattendus.
* **Récupérer les ID de disque pour les opérations en aval** Avant d’appeler des points de terminaison comme [Attacher un disque au serveur](https://gitlab.com/plenit-group/plenit-docs-es-es/-/blob/v1.0/reference/diskattachtoserver/README.md) ou [Supprimer un disque](https://gitlab.com/plenit-group/plenit-docs-es-es/-/blob/v1.0/reference/deletedisk/README.md), utilisez ce point de terminaison pour rechercher la cible `diskId`. Filtrez par `name` ou `publicName` pour localiser le disque spécifique par programme au lieu de coder les ID en dur.
* **Réconcilier les correspondances disque-serveur** Utilisez le `serverId` champ dans chaque réponse de disque pour construire une carte indiquant quels disques appartiennent à quels serveurs. Cela est utile pour les audits d’infrastructure, la réconciliation de facturation et la vérification que les configurations de serveur à plusieurs disques correspondent à votre architecture attendue.

## Obtenir les paramètres requis

* **subscriptionId** (requête) : Récupérez les ID d’abonnement disponibles en utilisant le [Lister tous les abonnements](https://gitlab.com/plenit-group/plenit-docs-es-es/-/blob/v1.0/reference/listallsubscriptions/README.md) point de terminaison. Passez votre `organizationId` comme paramètre de requête pour obtenir tous les abonnements de votre organisation, puis utilisez le `id` champ de la réponse.


---

# 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.plenit.com/fr/reference/servers-api/disk/listdisks.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.