Timeweb Cloud API: Создать базу данных и S3-хранилище

Сценарий из mcp-everything. Актуально на 2026-10-24.

Управляемая база и хранилище файлов для нового проекта — без ручной настройки в панели.

1. Создай кластер БД: POST /api/v1/databases с name, type (например, postgres16), preset_id, admin.login и admin.password, instance.name и availability_zone. Вместе с кластером создаётся и база.
2. Создай хранилище: POST /api/v1/storages/buckets с name, type (private или public) и preset_id.
3. Чтобы ресурсы были сгруппированы, создай проект заранее: POST /api/v1/projects — и передавай его project_id.
4. Следи за расходами: GET /api/v1/account/finances — balance, hourly_cost и monthly_cost.

curl -X POST https://api.timeweb.cloud/api/v1/databases \
  -H "Authorization: Bearer $TIMEWEB_CLOUD_TOKEN" -H 'Content-Type: application/json' \
  -d '{"name": "shop-db", "type": "postgres16", "preset_id": <ID тарифа БД>,
       "admin": {"login": "shop", "password": "<пароль>"}, "instance": {"name": "shop"}, "availability_zone": "msk-1"}'

Базовые URL

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

Авторизация

Тип: Bearer-токен

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

Authorization: Bearer $TIMEWEB_CLOUD_TOKEN

Методы сценария

GET /api/v1/account/finances — Платёжная информация

В ответе finances: balance, currency, discount_percent, hourly_cost, monthly_cost и др.

Параметр	Где	Тип	Обяз.	Описание
Authorization	header	string	да	Bearer <токен>

POST /api/v1/projects — Создание проекта

Параметр	Где	Тип	Обяз.	Описание
name	body	string	да	Имя проекта, до 255 символов
description	body	string	нет	Описание, до 255 символов
avatar_id	body	string	нет	ID аватара

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 проекта

POST /api/v1/storages/buckets — Создание S3-хранилища

Параметр	Где	Тип	Обяз.	Описание
name	body	string	да	Название
type	body	string	да	private или public
preset_id	body	number	нет	ID тарифа (нельзя вместе с configurator)
configurator.id	body	number	нет	ID конфигуратора
configurator.disk	body	number	нет	Размер, МБ
description	body	string	нет	Комментарий
project_id	body	number	нет	ID проекта

Нюансы

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

Другие сценарии

• Создать облачный сервер из скрипта
• Перезагрузить, выключить или изменить сервер
• Добавить DNS-запись домена

---

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