Облачные VDS

• Список виртуальных машин
• Создание ВМ
• Удаление ВМ
• Включение ВМ
• Выключение ВМ
• Перезагрузка ВМ
• Создание образа из ВМ
• Включение/выключение аварийного режима
• Смена тарифа
• Изменение имени ВМ
• Переустановка ОС

Список виртуальных машин

URL: /api/v1/cloud/vms/
Метод: GET
Результат: JSON

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

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

• offset: int – Индекс первой строки выборки, начиная с 0
• limit: int – Количество элементов в выборке в диапазоне от 1 до 100

Коды ответов

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

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

• count: int – Количество элементов
• entities – Список виртуальных машин
  • 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 GET 'https://api-ms.netangels.ru/api/v1/cloud/vms/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"

---

Создание ВМ

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

Создание ВМ из образа

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

• tariff: str – Тариф:
  • start_1 – Старт-1
  • start_2 – Старт-2
  • start_3 – Старт-3
  • start_4 – Старт-4
  • optima_1 – Оптима-1
  • optima_2 – Оптима-2
  • optima_3 – Оптима-3
  • optima_4 – Оптима-4
  • pro_1 – Про-1
  • pro_2 – Про-2
  • pro_3 – Про-3
  • turbo_1 – Турбо-1
  • turbo_2 – Турбо-2
  • turbo_3 – Турбо-3
  • turbo_4 – Турбо-4
  • turbopro_1 – ТурбоПро-1
  • turbopro_2 – ТурбоПро-2
  • turbopro_3 – ТурбоПро-3
  • ultra16 – Ультра-16
  • ultra32 – Ультра-32
  • ultra64 – Ультра-64
• disk_size: int – Размер диска
• image: str – Uid образа

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

• name: str – Имя VM
• ips_reserved: Список IP – Зарезервированные IP
• ipv4_count: int – Кол-во IPv4
• ipv6_count: int – Кол-во IPv6
• is_backup_enabled: bool – Включить/выключить бекапы
• key_name: str – Имя SSH-ключа
• key_value: str – SSH-ключ
• key_id: int – Идентификатор ключа
• create_packet: bool – Создавать пакет?
• uefi_support: bool – Включить UEFI
• gpu_type: str – GPU:
  • nvidia_a4000 – RTX A4000
  • nvidia_a5000 – RTX A5000
  • nvidia_v100 – Tesla V100
  • nvidia_a6000 – RTX A6000
  • `` – –
• gpu_count: int – Количество видеокарт
• enable_lan: bool – Включить приватную сеть

Создание ВМ из бекапа

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

• tariff: str – Тариф:
  • start_1 – Старт-1
  • start_2 – Старт-2
  • start_3 – Старт-3
  • start_4 – Старт-4
  • optima_1 – Оптима-1
  • optima_2 – Оптима-2
  • optima_3 – Оптима-3
  • optima_4 – Оптима-4
  • pro_1 – Про-1
  • pro_2 – Про-2
  • pro_3 – Про-3
  • turbo_1 – Турбо-1
  • turbo_2 – Турбо-2
  • turbo_3 – Турбо-3
  • turbo_4 – Турбо-4
  • turbopro_1 – ТурбоПро-1
  • turbopro_2 – ТурбоПро-2
  • turbopro_3 – ТурбоПро-3
  • ultra16 – Ультра-16
  • ultra32 – Ультра-32
  • ultra64 – Ультра-64
• disk_size: int – Размер диска
• resource_name: str – Имя бекапа
• backup_date: datetime64 – Дата бекапа

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

• name: str – Имя VM
• ips_reserved: Список IP – Зарезервированные IP
• ipv4_count: int – Кол-во IPv4
• ipv6_count: int – Кол-во IPv6
• is_backup_enabled: bool – Включить/выключить бекапы
• key_name: str – Имя SSH-ключа
• key_value: str – SSH-ключ
• key_id: int – Идентификатор ключа
• create_packet: bool – Создавать пакет?
• uefi_support: bool – Включить UEFI
• gpu_type: str – GPU:
  • nvidia_a4000 – RTX A4000
  • nvidia_a5000 – RTX A5000
  • nvidia_v100 – Tesla V100
  • nvidia_a6000 – RTX A6000
  • `` – –
• gpu_count: int – Количество видеокарт
• enable_lan: bool – Включить приватную сеть

Коды ответов

Код	Описание
201	Успешный запрос
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/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY" \
    --header "Content-Type: application/json" \
    --data '{
          "image": "img_trattas", 
          "key_value": "ssh-rsa Hridf9...jstJFHE user@laptop", 
          "key_id": 12 
    }'

---

Удаление ВМ

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

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

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

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

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

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

• archived: bool – Отправить в образы

Коды ответов

Код	Описание
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 DELETE 'https://api-ms.netangels.ru/api/v1/cloud/vms/{id}/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"

---

Включение ВМ

URL: /api/v1/cloud/vms/{id}/start/
Метод: 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}/start/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"

---

Выключение ВМ

URL: /api/v1/cloud/vms/{id}/stop/
Метод: 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}/stop/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"

---

Перезагрузка ВМ

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

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

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

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

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

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

• force: bool – Принудительная перезагрузка?

Коды ответов

Код	Описание
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}/restart/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"

---

Создание образа из ВМ

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

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

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

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

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

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

• name: str – Имя образа

Коды ответов

Код	Описание
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}/archive/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"

---

Включение/выключение аварийного режима

URL: /api/v1/cloud/vms/{id}/rescue-mode/
Метод: 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}/rescue-mode/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"

---

Смена тарифа

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

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

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

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

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

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

• tariff: str – Тариф:
  • start_1 – Старт-1
  • start_2 – Старт-2
  • start_3 – Старт-3
  • start_4 – Старт-4
  • optima_1 – Оптима-1
  • optima_2 – Оптима-2
  • optima_3 – Оптима-3
  • optima_4 – Оптима-4
  • pro_1 – Про-1
  • pro_2 – Про-2
  • pro_3 – Про-3
  • turbo_1 – Турбо-1
  • turbo_2 – Турбо-2
  • turbo_3 – Турбо-3
  • turbo_4 – Турбо-4
  • turbopro_1 – ТурбоПро-1
  • turbopro_2 – ТурбоПро-2
  • turbopro_3 – ТурбоПро-3
  • ultra16 – Ультра-16
  • ultra32 – Ультра-32
  • ultra64 – Ультра-64

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

• gpu_type: str – Тип GPU:
  • nvidia_a4000 – RTX A4000
  • nvidia_a5000 – RTX A5000
  • nvidia_v100 – Tesla V100
  • nvidia_a6000 – RTX A6000
  • `` – –
• gpu_count: int – Количество видеокарт

Коды ответов

Код	Описание
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-tariff/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY" \
    --header "Content-Type: application/json" \
    --data '{
          "tariff": "tiny" 
    }'

---

Изменение имени ВМ

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

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

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

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

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

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

• name: str – Имя VM

Коды ответов

Код	Описание
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-name/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY" \
    --header "Content-Type: application/json" \
    --data '{
          "name": "Солнце" 
    }'

---

Переустановка ОС

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

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

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

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

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

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

• image: str – Образ

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

• key_name: str – Имя SSH-ключа
• key_value: str – SSH-ключ
• key_id: int – Идентификатор ключа

Коды ответов

Код	Описание
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}/reinstall-image/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY" \
    --header "Content-Type: application/json" \
    --data '{
          "image": "img_trattas", 
          "key_value": "ssh-rsa Hridf9...jstJFHE user@laptop", 
          "key_id": 12 
    }'