Войти

Создание tenant

Stable

Как создавать tenant и что обязательно сохранить сразу после создания.

Обновлено: 5 марта 2026 г.

Создание tenant — это первый реальный шаг после получения API key. Именно tenant становится контейнером для всех будущих БД и общих credentials подключения.

Что передаётся при создании

Минимально нужен только name.

Пример через REST:

POST /v2/tenants
Authorization: Bearer <api-key>
Content-Type: application/json

{
  "name": "acme"
}

Что возвращает платформа

В ответ обычно приходят:

  • tenant;
  • pg_user;
  • pg_password;
  • dsn_template.

Что сделать сразу после ответа

  • сохранить pg_user;
  • сохранить pg_password;
  • сохранить dsn_template;
  • положить секреты в Secret Manager, CI secrets или другой защищённый контур.

Требования к имени

Используйте PostgreSQL‑friendly имя:

  • латиница;
  • цифры;
  • _ / $;
  • без пробелов и кириллицы.

Что важно не путать

  • API key нужен для Control Plane, Console и CLI;
  • pg_user / pg_password нужны для PostgreSQL‑подключения через Gateway.

Эти наборы секретов относятся к разным слоям платформы.

Почему это важно

Tenant — это не просто каталогический объект. На этом шаге вы получаете основной вход в ваши будущие базы. Если credentials потерять или оставить в небезопасном месте, дальнейшая работа станет сложнее и менее безопасной.

Почему SPG99АрхитектураПлан развитияДокументацияБлог