#Перезагрузить сервер

POST /v1/infra/servers/:id/reboot

Перезагружает работающий сервер у облачного провайдера. Во время перезагрузки сервер переходит в provisioning и возвращается в running через 30–90 секунд. Операция атомарная: внутренний guard на уровне базы предотвращает гонки, если одновременно пришло несколько вызовов. Если провайдер не поддерживает перезагрузку — возвращается 501 и статус откатывается на running.

#Параметры

Параметр В Тип Обяз. Описание
id path string (UUID) да ID сервера в статусе running

Тело запроса пустое.

#Примеры

#curl — личный ключ

Terminal 
curl -X POST -H "X-Api-Key: YOUR_API_KEY" \
  https://vibecode.bitrix24.tech/v1/infra/servers/SERVER_ID/reboot

#curl — OAuth-приложение

Terminal 
curl -X POST -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  https://vibecode.bitrix24.tech/v1/infra/servers/SERVER_ID/reboot

#JavaScript — личный ключ

javascript 
await fetch(
  `https://vibecode.bitrix24.tech/v1/infra/servers/${serverId}/reboot`,
  { method: 'POST', headers: { 'X-Api-Key': 'YOUR_API_KEY' } }
)

// Опрос готовности после перезагрузки
while (true) {
  await new Promise(r => setTimeout(r, 5000))
  const res = await fetch(
    `https://vibecode.bitrix24.tech/v1/infra/servers/${serverId}`,
    { headers: { 'X-Api-Key': 'YOUR_API_KEY' } }
  )
  const { data } = await res.json()
  if (data.status === 'running' && data.blackholeStatus === 'CONNECTED') break
}

#JavaScript — OAuth-приложение

javascript 
await fetch(
  `https://vibecode.bitrix24.tech/v1/infra/servers/${serverId}/reboot`,
  {
    method: 'POST',
    headers: {
      'X-Api-Key': 'YOUR_APP_KEY',
      'Authorization': 'Bearer USER_SESSION_TOKEN',
    },
  }
)

#Поля ответа

Поле Тип Описание
success boolean true. Команда на перезагрузку отправлена провайдеру

#Пример ответа

JSON 
{ "success": true }

#Пример ответа при ошибке

409 — статус сервера изменился во время операции (гонка):

JSON 
{
  "success": false,
  "error": {
    "code": "CONFLICT",
    "message": "Server state changed during operation"
  }
}

#Ошибки

HTTP Код Описание
401 MISSING_API_KEY Не передан заголовок X-Api-Key
401 INVALID_API_KEY Неверный или просроченный API-ключ
404 NOT_FOUND Сервер не в статусе running, удалён или принадлежит другому API-ключу
409 CONFLICT Гонка состояний — статус сервера изменился во время операции. Повторите запрос после проверки `GET /v1/infra/servers/:id`
429 RATE_LIMIT_EXCEEDED Превышен общий лимит запросов платформы
501 NOT_SUPPORTED Облачный провайдер не поддерживает перезагрузку. Используйте последовательность `/stop` → `/start`
502 PROVIDER_ERROR Облачный провайдер вернул ошибку. Статус сервера автоматически откатывается на running

Полный список общих ошибок API — Ошибки.

#Известные особенности

  • Атомарный переход running → provisioning. База обновляется одним updateMany с условием status = 'RUNNING'. Если в тот же момент прилетел ещё один /reboot или /stop, второй вызов получит 409 CONFLICT.
  • Автоматический откат при ошибке провайдера. Если adapter.rebootServer() кинул исключение, запись возвращается к статусу running — чтобы клиент не остался с «зависшим» provisioning.
  • Для перезапуска только приложения (без перезагрузки виртуальной машины) используйте `POST /exec` с командой systemctl restart app — это в десятки раз быстрее и не прерывает туннель.
  • После перезагрузки ждите оба поля. Чтобы сервер был готов к работе, нужны одновременно status: "running" и blackholeStatus: "CONNECTED" — туннель переподключается после старта виртуальной машины.

#Смотрите также