Для AI-агентов: markdown этой страницы — /docs-content/infra/lifecycle/repair.md индекс документации — /llms.txt

Восстановить туннель

POST /v1/infra/servers/:id/repair

Запускает фоновое восстановление туннеля Black Hole через serial console облачного провайдера. Используйте, когда виртуальная машина в running, но blackholeStatus застрял в DISCONNECTED или NONE — то есть агент туннеля не подключается. Процедура проходит через serial console (минуя файрвол) и включает: впрыск SSH-ключа → подключение к машине → полную переустановку агента с актуальной версией → ожидание переподключения. Длится до 2 минут (до 4 минут, если понадобился резервный путь установки — см. «Известные особенности»). Сам вызов возвращается сразу и не ждёт завершения, прогресс смотрите через GET /repair-status.

Перед восстановлением занятого канала прочитайте операцию. /repair переустанавливает агента туннеля и может прервать живые синхронные команды /exec и их побочные эффекты, включая транзакции во внешней базе. Длительные задачи отдельной машины выполняются независимо: восстановление или разрыв туннеля не гарантируют их остановку. При EXEC_BUSY сначала прочитайте операции сервера с kind=exec и их исходы. Гардированный /unstick используйте только при подтверждённой утечке синхронного мьютекса после независимого подтверждения простоя. DELETE /lock остаётся последним шагом восстановления лока после этой проверки. /repair нужен, когда туннель действительно не подключается; он не служит отменой или разрешением повторить команду. На STANDALONE работающая длительная задача занимает канал после освобождения платформенного лока с 202. Опрашивайте её операцию; при неизвестном исходе нужны поддержка и независимое подтверждение полной остановки. Отсутствие autoExpiresInSeconds не доказывает утечку мьютекса. Восстановление туннеля и удаление лока не снимают ограничение приёма длительной задачи. В Galaxy команды выполняются синхронно с пределом 600 секунд и общим каналом для всех приложений и выкладок; задача соседнего приложения может не попасть в ваш список операций, поэтому пустой список не доказывает простой хоста.

Параметры

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

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

Примеры

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

Terminal

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

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/repair

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

javascript

// Запустить ремонт и периодически опрашивать статус
await fetch(
  `https://vibecode.bitrix24.tech/v1/infra/servers/${serverId}/repair`,
  { method: 'POST', headers: { 'X-Api-Key': 'YOUR_API_KEY' } }
)

while (true) {
  await new Promise(r => setTimeout(r, 10000))
  const res = await fetch(
    `https://vibecode.bitrix24.tech/v1/infra/servers/${serverId}/repair-status`,
    { headers: { 'X-Api-Key': 'YOUR_API_KEY' } }
  )
  const { data } = await res.json()
  console.log(`Шаг: ${data.step ?? data.status}`)
  if (data.status === 'idle' || data.status === 'completed' || data.status === 'failed') break
}

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

javascript

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

Поля ответа

Поле	Тип	Описание
`success`	boolean	`true` — ремонт успешно запущен в фоне
`data.status`	string	Всегда `"started"` при успехе

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

JSON

{
  "success": true,
  "data": { "status": "started" }
}

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

409 — ремонт заблокирован (например, сервер помечен preventWake=true):