Быстрый старт: REST

Ниже — минимальный пользовательский путь через REST без использования Console.

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"}'

Сохраните pg_user, pg_password и dsn_template из ответа.

3. Создайте базу

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"}'

В текущем managed‑сценарии не используйте start_immediately и initial_scale: база стартует автоматически при первом подключении через Gateway.

4. При необходимости перечитайте credentials

curl -sS "$CP_URL/v2/tenants/t1/credentials"       -H "Authorization: Bearer $SPG99_TOKEN"

5. Подключитесь к PostgreSQL через Gateway

Соберите DSN по шаблону:

postgres://<pg_user>:<pg_password>@<gateway-host>:5432/d1?sslmode=require

Пример:

psql "postgres://tnt_xxxxx:secret@pg.spg99.ru:5432/d1?sslmode=require"

Если база была в stopped, первое подключение может занять чуть больше времени: платформа выполнит cold start автоматически.

6. Проверьте состояние базы

curl -sS "$CP_URL/v2/tenants/t1/dbs/d1"       -H "Authorization: Bearer $SPG99_TOKEN"

Это полезно, чтобы увидеть state, current_scale, target_scale, worker_id и другие runtime‑поля.

Главное правило

Для managed‑сценария SPG99 достаточно помнить один простой workflow:

create tenant -> save credentials -> create db -> connect through Gateway