Quickstart: REST

Stable

Минимальный сценарий через REST: create tenant/db → start → connect.

Обновлено: 4 февраля 2026 г.

Минимальный сценарий работы только через API v2 (без Console/CLI).

1) Переменные окружения

export CP_URL="https://<cp-host>"
export SPG99_TOKEN="<api-key>"

2) Создайте tenant

curl -sS -X POST "$CP_URL/v2/tenants"   -H "Authorization: Bearer $SPG99_TOKEN"   -H "Content-Type: application/json"   -d '{"name":"t1"}' | jq .

В ответе вы получите pg_user, pg_password и dsn_template — сохраните их.

3) Создайте БД (compute пока не стартуем)

curl -sS -X POST "$CP_URL/v2/tenants/t1/dbs"   -H "Authorization: Bearer $SPG99_TOKEN"   -H "Content-Type: application/json"   -d '{"name":"d1","size":"L1","start_immediately":false,"initial_scale":0}' | jq .

4) Запустите compute и проверьте состояние

curl -sS -X POST "$CP_URL/v2/tenants/t1/dbs/d1/start"   -H "Authorization: Bearer $SPG99_TOKEN"   -H "Content-Type: application/json"   -d '{"scale":1}' | jq .

curl -sS -X GET "$CP_URL/v2/tenants/t1/dbs/d1"   -H "Authorization: Bearer $SPG99_TOKEN" | jq .

5) Подключитесь к PostgreSQL

Соберите DSN из dsn_template, заменив <db-name> на d1, и подключайтесь к Gateway (<gateway-host>:5432).