Timeweb Cloud API: POST /api/v1/databases — Создание кластера БД

Вместе с кластером создаётся инстанс. Ответ — объект db.

Параметр	Где	Тип	Обяз.	Описание
name	body	string	да	Название кластера
type	body	string	да	Тип: mysql, mysql8_4, postgres14…postgres18, valkey7, mongodb7, clickhouse и др.
preset_id	body	integer	нет	ID тарифа (нельзя вместе с configuration)
configuration.configurator_id	body	integer	нет	ID конфигуратора
configuration.disk	body	integer	нет	Диск, МБ
configuration.cpu	body	integer	нет	Ядра
configuration.ram	body	integer	нет	ОЗУ, МБ
admin.login	body	string	нет	Пользователь БД
admin.password	body	string	нет	Пароль
instance.name	body	string	нет	Название базы
network.id	body	string	нет	ID сети
replication.count	body	number	нет	Число реплик
availability_zone	body	string	нет	Зона доступности
project_id	body	integer	нет	ID проекта

Базовые URL

• Боевой: https://api.timeweb.cloud

Авторизация

Тип: Bearer-токен

JWT-токен создаётся в панели управления в разделе «API и Terraform» и передаётся в каждом запросе:

Authorization: Bearer $TIMEWEB_CLOUD_TOKEN

Нюансы

• Тело POST, PUT, PATCH — application/json.
• Пагинация и поиск в коллекциях: limit, offset, search, sort.
• Ответы на GET содержат объект сущности по ключу, meta.total для коллекций и response_id (UUIDv4, приложите его в обращении в поддержку).
• Созданный ресурс может быть ещё «в состоянии запуска» — проверяйте поле status.
• Около 380 методов; кроме перечисленных — выделенные серверы, диски и бэкапы, образы, Kubernetes, балансировщики, VPC, плавающие IP, приложения, CDN, реестр контейнеров, ограничения доступа к аккаунту.

Сценарии с этим методом

• Создать базу данных и S3-хранилище

---

Если этого недостаточно — официальная документация: https://timeweb.cloud/api-docs Вся интеграция одним документом: https://mcp-everything.ru/integrations/timeweb-cloud.md