CLOUD PRIME API

Catálogo

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, 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
                    }
                }
            ]
        }
    ]
}