Timeweb Cloud API: POST /api/v1/servers — Создание сервера

Нужен preset_id или configuration (одно из двух). Ответ 201 с объектом server; сервер может ещё запускаться — смотрите status.

Параметр	Где	Тип	Обяз.	Описание
name	body	string	да	Имя сервера, до 255 символов
preset_id	body	number	нет	ID тарифа (нельзя вместе с configuration)
configuration.configurator_id	body	number	нет	ID конфигуратора (обязателен внутри configuration)
configuration.disk	body	number	нет	Диск, МБ
configuration.cpu	body	number	нет	Число ядер
configuration.ram	body	number	нет	ОЗУ, МБ
configuration.gpu	body	number	нет	Число видеокарт
os_id	body	number	нет	ID ОС (нельзя вместе с image_id)
image_id	body	string	нет	ID образа
software_id	body	number	нет	ID ПО из маркетплейса
bandwidth	body	number	нет	Пропускная способность: 100–1000 с шагом 100
is_ddos_guard	body	boolean	нет	Защищённый IP (L3/L4)
ssh_keys_ids	body	array	нет	SSH-ключи
is_local_network	body	boolean	нет	Локальная сеть
network.id	body	string	нет	ID приватной сети
network.floating_ip	body	string	нет	Публичный IP
network.local_ip	body	string	нет	Приватный IP
cloud_init	body	string	нет	Cloud-init скрипт
availability_zone	body	string	нет	spb-1…spb-4, msk-1, nsk-1, ams-1, ala-1, fra-1
project_id	body	number	нет	ID проекта
hostname	body	string	нет	Сетевое имя
comment	body	string	нет	Комментарий, до 255 символов

Базовые 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, реестр контейнеров, ограничения доступа к аккаунту.

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

• Создать облачный сервер из скрипта

---

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