Облачные VDS

• VNC-консоль
• Изменение пароля root
• Предоставление доступа для СТП
• Отмена доступа для СТП

VNC-консоль

URL: /api/v1/cloud/vms/{id}/vnc/
Метод: POST
Результат: JSON

Параметры запроса

Обязательные параметры:

• id: int – ID виртуальной машины

Коды ответов

Код	Описание
200	Успешный запрос

Возвращаемое значение

VNC

• display: str – Экран
• host: str – Хост
• password: str – Пароль
• port: str – Порт
• wsport: str – Web Socket порт

Пример запроса

curl --request POST 'https://api-ms.netangels.ru/api/v1/cloud/vms/{id}/vnc/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"

---

Изменение пароля root

URL: /api/v1/cloud/vms/{id}/change-password/
Метод: POST
Результат: JSON

Параметры запроса

Обязательные параметры:

• id: int – ID виртуальной машины

Параметры тела запроса

Обязательные параметры:

• username: str – Логин пользователя на ВМ
• password: str – Пароль для доступа по SSH

Коды ответов

Код	Описание
200	Успешный запрос
400	Данные в запросе имеют неверный формат или отсутствуют обязательные параметры

Возвращаемое значение

Виртуальная машина

• id: int – Идентификатор виртуальной машины
• uid: str – Уникальный идентификатор виртуальной машины, например, vm_5ba4bca0
• name: str – Имя виртуальной машины
• master_server: str – Имя сервера
• tariff: str – Тариф
• main_ip: str – Главный IP-адрес
• lan_ip: str – IP-адрес в локальной сети
• is_protected: bool – Подключена ли защита от DDOS
• volumes: Sequence[Disk] – Дополнительные диски
• image: Image – Образ или дистрибутив
• finance: VMFinance – Финансы
• disk: Disk – Основной диск
• bandwidth: int – Полоса пропускания при защите от DDOS
• state: str – Статус:
  • Active – Включена
  • Error – Ошибка
  • Stopped – Выключена пользователем
  • StoppedByAdmin – Выключена администратором
  • Building – Создание
  • StoppedByService – Отключен за неуплату
  • Starting – Запуск
  • Stopping – Остановка
  • OfflineMigrating – Миграция
  • LiveMigrating – Миграция
  • Backuping – Резервное копирование
  • Restoring – Восстановление
  • Restarting – Перезагрузка
  • Archiving – Создание образа
  • TariffUpdate – Изменение тарифа
  • DiskUpdating – Изменение диска
  • RescueMode – Режим восстановления
  • Transfer – Передача на другой аккаунт
• created: datetime – Дата создания
• updated: datetime – Дата изменения
• backup_settings: list[Backup] – Бекапы
• hostname: str – Имя хоста
• support_access: bool – Доступ службе технической поддержки
• ips: Sequence[VMIP] – Список IP-адресов
• is_managed: bool – Статус агента
• transitions: Sequence[Task] – Текущие и запланированные задачи над ВМ

Пример запроса

curl --request POST 'https://api-ms.netangels.ru/api/v1/cloud/vms/{id}/change-password/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY" \
    --header "Content-Type: application/json" \
    --data '{
          "password": "DFsdRdf234sd" 
    }'

---

Предоставление доступа для СТП

URL: /api/v1/cloud/vms/{id}/support-access/
Метод: POST
Результат: JSON

Параметры запроса

Обязательные параметры:

• id: int – ID виртуальной машины

Коды ответов

Код	Описание
200	Успешный запрос

Возвращаемое значение

Виртуальная машина

• id: int – Идентификатор виртуальной машины
• uid: str – Уникальный идентификатор виртуальной машины, например, vm_5ba4bca0
• name: str – Имя виртуальной машины
• master_server: str – Имя сервера
• tariff: str – Тариф
• main_ip: str – Главный IP-адрес
• lan_ip: str – IP-адрес в локальной сети
• is_protected: bool – Подключена ли защита от DDOS
• volumes: Sequence[Disk] – Дополнительные диски
• image: Image – Образ или дистрибутив
• finance: VMFinance – Финансы
• disk: Disk – Основной диск
• bandwidth: int – Полоса пропускания при защите от DDOS
• state: str – Статус:
  • Active – Включена
  • Error – Ошибка
  • Stopped – Выключена пользователем
  • StoppedByAdmin – Выключена администратором
  • Building – Создание
  • StoppedByService – Отключен за неуплату
  • Starting – Запуск
  • Stopping – Остановка
  • OfflineMigrating – Миграция
  • LiveMigrating – Миграция
  • Backuping – Резервное копирование
  • Restoring – Восстановление
  • Restarting – Перезагрузка
  • Archiving – Создание образа
  • TariffUpdate – Изменение тарифа
  • DiskUpdating – Изменение диска
  • RescueMode – Режим восстановления
  • Transfer – Передача на другой аккаунт
• created: datetime – Дата создания
• updated: datetime – Дата изменения
• backup_settings: list[Backup] – Бекапы
• hostname: str – Имя хоста
• support_access: bool – Доступ службе технической поддержки
• ips: Sequence[VMIP] – Список IP-адресов
• is_managed: bool – Статус агента
• transitions: Sequence[Task] – Текущие и запланированные задачи над ВМ

Пример запроса

curl --request POST 'https://api-ms.netangels.ru/api/v1/cloud/vms/{id}/support-access/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"

---

Отмена доступа для СТП

URL: /api/v1/cloud/vms/{id}/support-access/
Метод: DELETE
Результат: JSON

Параметры запроса

Обязательные параметры:

• id: int – ID виртуальной машины

Коды ответов

Код	Описание
200	Успешный запрос

Возвращаемое значение

Виртуальная машина

• id: int – Идентификатор виртуальной машины
• uid: str – Уникальный идентификатор виртуальной машины, например, vm_5ba4bca0
• name: str – Имя виртуальной машины
• master_server: str – Имя сервера
• tariff: str – Тариф
• main_ip: str – Главный IP-адрес
• lan_ip: str – IP-адрес в локальной сети
• is_protected: bool – Подключена ли защита от DDOS
• volumes: Sequence[Disk] – Дополнительные диски
• image: Image – Образ или дистрибутив
• finance: VMFinance – Финансы
• disk: Disk – Основной диск
• bandwidth: int – Полоса пропускания при защите от DDOS
• state: str – Статус:
  • Active – Включена
  • Error – Ошибка
  • Stopped – Выключена пользователем
  • StoppedByAdmin – Выключена администратором
  • Building – Создание
  • StoppedByService – Отключен за неуплату
  • Starting – Запуск
  • Stopping – Остановка
  • OfflineMigrating – Миграция
  • LiveMigrating – Миграция
  • Backuping – Резервное копирование
  • Restoring – Восстановление
  • Restarting – Перезагрузка
  • Archiving – Создание образа
  • TariffUpdate – Изменение тарифа
  • DiskUpdating – Изменение диска
  • RescueMode – Режим восстановления
  • Transfer – Передача на другой аккаунт
• created: datetime – Дата создания
• updated: datetime – Дата изменения
• backup_settings: list[Backup] – Бекапы
• hostname: str – Имя хоста
• support_access: bool – Доступ службе технической поддержки
• ips: Sequence[VMIP] – Список IP-адресов
• is_managed: bool – Статус агента
• transitions: Sequence[Task] – Текущие и запланированные задачи над ВМ

Пример запроса

curl --request DELETE 'https://api-ms.netangels.ru/api/v1/cloud/vms/{id}/support-access/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"