Datacenters

Liste os datacenters ativos, IPs disponíveis e os templates de SO aninhados em cada um.

4 min de leitura Atualizado em 25 de maio de 2026

O que você vai conseguir

Liste os datacenters ativos, IPs disponíveis e os templates de SO de cada um.

Antes de começar

  • Autenticação via token Bearer no header Authorization.
  • As rotas operam apenas sobre os recursos do cliente autenticado.

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.

Endpoints

GET /api/datacenters

Listar datacenters e templates de SO

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

CampoTipoDescrição
iduuidID do datacenter — use como datacenter_id.
namestringNome do datacenter.
locationstringLocalidade (cidade).
regionstringRegião.
available_ipsintegerIPs livres no pool. Precisa ser > 0 para provisionar.
os_templatesarrayTemplates de SO disponíveis neste datacenter (ver abaixo).

Campos de os_templates[]

CampoTipoDescrição
iduuidID do template — use como os_template_id.
display_namestringNome amigável (ex.: Ubuntu 22.04 LTS).
name / versionstringNome técnico e versão do SO.
os_family / os_typestringFamília (linux/windows) e tipo do SO.
additional_pricenumberCusto adicional do template, se houver.
min_requirementsobjectcpu_cores, ram_gb, storage_gb mínimos exigidos.
{
    "data": [
        {
            "id": "4a2b1c3d-...",
            "name": "São Paulo - SP1",
            "location": "São Paulo",
            "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
                    }
                }
            ]
        }
    ]
}

A sua privacidade é muito importante para nós

Nós usamos cookies para garantir a melhor experiência e para coletar dados sobre como os visitantes interagem com o nosso site. Ao clicar em "Aceitar todos", você concorda em usarmos todos os cookies para anúncios, personalização e análises, como descrito na nossa Política de cookies.