Управление VPS

Маршруты раздела «Управление VPS» для интеграции Cloud API.

📄️Список VPS

Возвращает VPS только этой интеграции. api_user_id фильтрует по вашему идентификатору клиента. total_count — количество всех записей с выбранными фильтрами до limit/offset.

📄️Детали VPS

Возвращает ресурсы, локацию, ОС, адреса, срок оплаты и автопродление. Исходный пароль и SSH-ключ VPS в ответ не входят.

📄️Состояние питания

Возвращает текущее состояние питания и uptime в секундах.

📄️Мониторинг

Выберите интервал и агрегацию (AVERAGE или MAX). null означает отсутствие замера, а не ноль. time — Unix timestamp; скорость сети — Мбит/с, память — байты, скорость диска — байты/с.

📄️Расход трафика

Возвращает текущий период, квоту, расход и ограничение скорости. Счётчики в байтах и время относятся к последнему доступному замеру. Отсутствующий период или ограничение обозначается null.

📄️Ссылка на консоль

Создаёт одноразовую ссылку консоли со сроком expires_at. api_key_id передаётся в query; JSON-тела и Idempotency-Key нет. Ответ содержит Cache-Control: no-store.

start запускает VPS; shutdown и reboot запрашивают штатное выключение/перезагрузку ОС. stop принудительно выключает питание, reset принудительно перезагружает; несохранённые данные могут быть потеряны.

📄️Сбросить пароль

Меняет пароль существующего пользователя ОС (login по умолчанию root) через гостевой агент. Требуется работающий агент. Ошибка или неподтверждённый результат не доказывают, что пароль остался прежним: проверьте доступ перед новой командой.

📄️Переустановить ОС

Пересоздаёт системный диск с удалением его данных. Дополнительные диски сохраняются, если wipe_extra_disks=false. Передайте пароль либо публичный SSH-ключ; без обоих сохраняются настройки доступа установки. Оба сразу недопустимы. ID VPS, сеть и оплаченный срок сохраняются.

📄️Включить Rescue

Перезагружает VPS в Rescue, сохраняя диски и сеть. Требуется не менее 2048 МиБ RAM и оплаченный VPS. Передайте временный пароль; после успеха подключайтесь root по SSH к IP VPS, порт 22. Правила firewall продолжают действовать. В Rescue недоступны смена тарифа, переустановка ОС и сброс пароля основной ОС. Проверяйте операцию и rescue в деталях VPS. При rescue_not_ready или requires_review=true проверьте состояние и выйдите из Rescue; повторяйте потерянный запрос с исходным Idempotency-Key.

📄️Выключить Rescue

Выходит из Rescue и восстанавливает загрузку обычной ОС. Оплаченный VPS запускается; при истёкшей оплате или приостановке остаётся выключенным. Выход доступен также из состояния error, если контекст Rescue сохранён. api_key_id передаётся в query, тело и пароль не нужны. Используйте отдельный Idempotency-Key для команды выхода.

📄️Удалить VPS

Безвозвратно удаляет VPS. keep_ips — обязательный query-параметр. true сохраняет IPv4, включая основной, как отдельно оплачиваемые адреса; false освобождает их. Результат содержит held_ips. Неиспользованный срок VPS не возвращается.

📄️История операций

Операции и оплаченные заказы имеют разные идентификаторы. data.id ответа команды — operation_id. queued/running не означают завершение; succeeded/failed — конечный результат команды. В истории также бывает cancelled. result заполняется только при успешном удалении, назначении/снятии IP, смене пароля и переустановке; остальное состояние читайте через маршруты статуса/firewall.