Datacenters

Datacenters disponíveis e os templates de SO de cada um. Use o id do datacenter como datacenter_id e um os_templates[].id como os_template_id no provisionamento.

Onde ficam os templates de SO
Não há endpoint separado de templates — eles vêm aninhados em cada datacenter, no array os_templates da resposta abaixo.

Listar datacenters e templates de SO

GET /api/datacenters

Retorna os datacenters ativos que têm IP disponível para provisionar, a quantidade de IPs livres e os templates de SO de cada um. Datacenter sem IP livre não aparece na lista, então todo id retornado aceita pedido no momento da consulta.

Campos do datacenter

Campo	Tipo	Descrição
`id`	uuid	ID do datacenter — use como datacenter_id.
`name`	string	Nome do datacenter.
`location`	string	Localidade (cidade).
`region`	string	Região.
`available_ips`	integer	IPs livres no pool. Sempre maior que zero, porque datacenter sem IP livre não é listado.
`os_templates`	array	Templates de SO disponíveis neste datacenter (ver abaixo).

Campos de os_templates[]

Campo	Tipo	Descrição
`id`	uuid	ID do template — use como os_template_id.
`display_name`	string	Nome amigável (ex.: Ubuntu 22.04 LTS).
`name / version`	string	Nome técnico e versão do SO.
`os_family / os_type`	string	Família (linux/windows) e tipo do SO.
`additional_price`	number	Custo adicional do template, se houver.
`min_requirements`	object	cpu_cores, ram_gb, storage_gb mínimos exigidos.

Exemplo de resposta

{
    "data": [
        {
            "id": "4a2b1c3d-...",
            "name": "Sudeste - SE1",
            "location": "Região Sudeste",
            "region": "BR-SE",
            "available_ips": 128,
            "os_templates": [
                {
                    "id": "5e1b0c9a-...",
                    "name": "ubuntu",
                    "version": "22.04",
                    "display_name": "Ubuntu 22.04 LTS",
                    "os_family": "linux",
                    "os_type": "ubuntu",
                    "is_featured": true,
                    "additional_price": 0,
                    "min_requirements": {
                        "cpu_cores": 1,
                        "ram_gb": 1,
                        "storage_gb": 10
                    }
                }
            ]
        }
    ]
}