Справочник команд

SPGCLI (spgctl) — legacy CLI над тем же Control Plane API, который использует Console. Для новых пользовательских сценариев и интеграций используйте Console или API v2; этот справочник оставлен для совместимости с существующей автоматизацией.

Базовая проверка доступа

spgctl ping --json

Эта команда удобна, чтобы быстро убедиться, что CP_URL и SPG99_TOKEN настроены правильно.

Tenant

Создать tenant:

spgctl tenant create --name acme

Получить список tenants:

spgctl tenant list

Посмотреть детали tenant:

spgctl tenant get --name acme

Базы данных

Создать базу:

spgctl db create --tenant acme --name app --size L1

Посмотреть состояние базы:

spgctl db describe --tenant acme --db app

Получить готовый DSN:

spgctl db dsn --tenant acme --db app

Удалить базу:

spgctl db delete --tenant acme --db app --force

Что важно помнить

• spgctl управляет ресурсами через Control Plane, но не заменяет PostgreSQL‑клиент;
• для обычного подключения к БД используйте psql или драйвер приложения с DSN из spgctl db dsn;
• для новых сценариев предпочтительнее Console и API v2;
• ручной start/stop/scale не является обычным публичным сценарием managed‑контура — база просыпается на первом подключении через Gateway.

Как читать этот справочник

Набор флагов может постепенно расширяться. Если вам нужен точный синтаксис вашей версии CLI, проверяйте:

spgctl --help
spgctl tenant --help
spgctl db --help

Для сопровождения существующей automation этого достаточно, чтобы закрыть создание tenant, создание базы, получение DSN и первичную диагностику.