> 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/docs-pt/reference/servers-api/disk/listdisks.md).

# Casos de utilização

* **Inventariar todos os discos numa subscrição** Chame este endpoint para obter uma visão completa de todos os discos — discos raiz, discos de dados e volumes não anexados — dentro de uma subscrição. Use o `tipo` e `estado` campos na resposta para categorizar e auditar os seus recursos de armazenamento.
* **Encontrar discos não anexados disponíveis para reutilização** Filtre a resposta verificando discos em que `serverId` é `null`. Estes são discos que não estão atualmente anexados a nenhum servidor e podem ser anexados a um servidor novo ou existente usando o [Anexar disco ao servidor](https://gitlab.com/plenit-group/plenit-docs-es-es/-/blob/v1.0/reference/diskattachtoserver/README.md) endpoint, evitando a criação desnecessária de discos.
* **Monitorizar o estado e a capacidade do disco** Consulte periodicamente este endpoint para acompanhar os estados dos discos (por ex., `Pronto`, provisionamento) e tamanhos em toda a sua infraestrutura. Crie alertas ou painéis que assinalem discos próximos dos limites de capacidade ou presos em estados inesperados.
* **Obter IDs dos discos para operações subsequentes** Antes de chamar endpoints como [Anexar disco ao servidor](https://gitlab.com/plenit-group/plenit-docs-es-es/-/blob/v1.0/reference/diskattachtoserver/README.md) ou [Eliminar um disco](https://gitlab.com/plenit-group/plenit-docs-es-es/-/blob/v1.0/reference/deletedisk/README.md), use este endpoint para procurar o alvo `diskId`. Filtre por `name` ou `publicName` para localizar o disco específico programaticamente em vez de codificar IDs manualmente.
* **Reconciliar mapeamentos de disco para servidor** Use o `serverId` campo em cada resposta de disco para construir um mapa de quais discos pertencem a quais servidores. Isto é útil para auditorias de infraestrutura, reconciliação de faturação e verificação de que configurações de servidor com vários discos correspondem à sua arquitetura esperada.

## Obter os parâmetros necessários

* **subscriptionId** (query): Obtenha os IDs de subscrição disponíveis usando o [Listar todas as subscrições](https://gitlab.com/plenit-group/plenit-docs-es-es/-/blob/v1.0/reference/listallsubscriptions/README.md) endpoint. Passe o seu `organizationId` como parâmetro de consulta para obter todas as subscrições da sua organização e, depois, use o `id` campo da resposta.


---

# 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/docs-pt/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.