#Удалить сервер

DELETE /v1/infra/servers/:id

Удаляет сервер безвозвратно: виртуальная машина уничтожается у провайдера, запись в базе помечается как DELETED, открытые биллинг-транзакции финализируются. Восстановить удалённый сервер нельзя — создавайте новый через `POST /v1/infra/servers`. Удаление идемпотентно только на уровне виртуальной машины у провайдера (если она уже удалена у провайдера, ошибки не будет); повторный вызов для уже помеченного сервера вернёт 404.

#Параметры

Параметр В Тип Обяз. Описание
id path string (UUID) да ID сервера из `POST /v1/infra/servers` или `GET /v1/infra/servers`

#Примеры

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

Terminal 
curl -X DELETE -H "X-Api-Key: YOUR_API_KEY" \
  https://vibecode.bitrix24.tech/v1/infra/servers/db008c84-91a5-4e15-b9d5-6c6aa2838448

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

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

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

javascript 
const res = await fetch(
  `https://vibecode.bitrix24.tech/v1/infra/servers/${serverId}`,
  {
    method: 'DELETE',
    headers: { 'X-Api-Key': 'YOUR_API_KEY' },
  }
)
const { success } = await res.json()
if (success) console.log('Сервер удалён')

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

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

#Поля ответа

Поле Тип Описание
success boolean true при успешном удалении

Ответ короткий — тело { "success": true } подтверждает факт удаления. Дополнительных данных не возвращается.

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

JSON 
{
  "success": true
}

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

404 — сервер уже удалён или не существует:

JSON 
{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Server not found"
  }
}

#Ошибки

HTTP Код Описание
401 MISSING_API_KEY Не передан заголовок X-Api-Key
401 INVALID_API_KEY Неверный или просроченный API-ключ
404 NOT_FOUND Сервер не найден, принадлежит другому API-ключу, или уже был удалён
429 RATE_LIMIT_EXCEEDED Превышен общий лимит запросов платформы

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

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

  • Обработка 404 при повторах — норма. Если клиент потерял соединение после первого DELETE, повтор вернёт 404. Ловите 404 как «уже удалено».
  • Если виртуальная машина уже удалена у провайдера другим способом (панель провайдера, ручная очистка) — DELETE всё равно отработает успешно и пометит запись в базе как удалённую.
  • Квота освобождается сразу. После удаления можно сразу создавать новый сервер — MAX_SERVERS_REACHED больше не будет считать эту запись.
  • Удаление работает для любого статуса. Сервер в provisioning, running, sleeping и error — все удаляются штатно.

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