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 arrayos_templatesda resposta abaixo.
Listar datacenters e templates de SO
GET
/api/datacenters
Retorna os datacenters ativos, a quantidade de IPs disponíveis e os templates de SO de cada um.
Verifique available_ips > 0 — datacenter sem IP livre recusa o provisionamento.
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. Precisa ser > 0 para provisionar. |
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
}
}
]
}
]
}