Управление VPS
Маршруты раздела «Управление VPS» для интеграции Cloud API.
Список VPS
Возвращает VPS только этой интеграции. api_user_id фильтрует по вашему идентификатору клиента. total_count — количество всех записей с выбранными фильтрами до limit/offset.
Детали VPS
Возвращает ресурсы, локацию, ОС, адреса, срок оплаты и автопродление. Исходный пароль и SSH-ключ VPS в ответ не входят.
Состояние питания
Возвращает текущее состояние питания и uptime в секундах.
Доступность ноды VPS
Доступность текущей ноды выбранной VPS. Проверяется принадлежность VPS интеграции; ID и имя ноды не публикуются. Это аптайм инфраструктуры, не время работы гостевой ОС. После переноса VPS ответ относится к новой ноде.
Мониторинг
Выберите интервал и агрегацию (AVERAGE или MAX). null означает отсутствие замера, а не ноль. time — Unix timestamp; скорость сети — Мбит/с, память — байты, скорость диска — байты/с.
Расход трафика
Возвращает текущий период, квоту, расход и ограничение скорости. Счётчики в байтах и время относятся к последнему доступному замеру. Отсутствующий период или ограничение обозначается null.
История трафика
Возвращает всю накопленную историю входящего и исходящего трафика VPS по дням UTC, от старых к новым, без пагинации. Значения указаны в байтах; квоту расходует исходящий трафик. История доступна владельцу и после удаления VPS. Если наблюдений ещё нет, days — пустой массив. Дни без наблюдений не добавляются, старый расход до начала сбора дневной истории не восстанавливается.
Ссылка на консоль
Создаёт одноразовую ссылку консоли со сроком expires_at. api_key_id передаётся в query; JSON-тела и Idempotency-Key нет. Ответ содержит Cache-Control: no-store.
Ссылка на терминал
Создаёт одноразовую ссылку на браузерный терминал работающего VPS, действующую пять минут до первого использования. api_key_id передаётся в query; JSON-тело и Idempotency-Key не нужны. Ответ содержит Cache-Control: no-store. Открывайте полученный URL целиком: он даёт доступ к терминалу этой VPS.
Управление питанием
start запускает VPS; shutdown и reboot запрашивают штатное выключение/перезагрузку ОС. stop принудительно выключает питание, reset принудительно перезагружает; несохранённые данные могут быть потеряны.
Сбросить пароль
Меняет пароль существующего пользователя ОС через гостевой агент. Если login отсутствует или равен null, используется фактический логин установки: обычно admin для Windows и root для Linux. Если логин неизвестен, HTTP 409 с кодом vm_login_required требует передать login явно. Явно указанный логин сохраняется. Требования к паролю Windows проверяет гостевая ОС. Нужен работающий гостевой агент. Ошибка или неподтверждённый результат не доказывают, что пароль остался прежним: проверьте доступ перед новой командой.
Переустановить ОС
Пересоздаёт системный диск с удалением его данных. Дополнительные диски сохраняются, если 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.
Результат операции
Операции и оплаченные заказы имеют разные идентификаторы. data.id ответа команды — operation_id. queued/running не означают завершение; succeeded/failed — конечный результат команды. В истории также бывает cancelled. result заполняется только при успешном удалении, назначении/снятии IP, смене пароля и переустановке; остальное состояние читайте через маршруты статуса/firewall.