Command Reference

SPGCLI (spgctl) is a legacy CLI on top of the same Control Plane API used by Console. For new user workflows and integrations, use Console or API v2; this reference remains only for compatibility with existing automation.

Basic access check

spgctl ping --json

This command is convenient when you want to quickly verify that CP_URL and SPG99_TOKEN are configured correctly.

Tenant

Create a tenant:

spgctl tenant create --name acme

Get the list of tenants:

spgctl tenant list

View tenant details:

spgctl tenant get --name acme

Databases

Create a database:

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

View the database state:

spgctl db describe --tenant acme --db app

Get a ready-to-use DSN:

spgctl db dsn --tenant acme --db app

Delete a database:

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

What is important to remember

• spgctl manages resources through the Control Plane, but it does not replace a PostgreSQL client;
• for a normal database connection, use psql or your application driver with the DSN from spgctl db dsn;
• for new workflows, prefer Console and API v2;
• manual start/stop/scale is not a normal public scenario in the managed environment — the database wakes up on the first connection through Gateway.

How to read this reference

The set of flags may gradually expand. If you need the exact syntax for your CLI version, check:

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

For maintaining existing automation, this is enough to cover tenant creation, database creation, DSN retrieval, and basic diagnostics.