Облачные VDS

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

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

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

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

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

offset: int - Индекс первой строки выборки, начиная с 0
limit: int - Количество элементов в выборке в диапазоне от 10 до 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 - Start-1
- start_2 - Start-2
- start_3 - Start-3
- start_4 - Start-4
- tiny - Tiny
- small - Small
- medium - Medium
- large - Large
- xl16_big - XL16
- xl32_big - XL32
- xl64_big - XL64
- bitrix_s - Bitrix-S
- bitrix_m - Bitrix-M
- bitrix_l - Bitrix-L
- bitrix_xl - Bitrix-XL
- bitrix_xxl - Bitrix-XXL
- ultra16 - Ultra-16
- ultra32 - Ultra-32
- ultra64 - Ultra-64
- service1 - Service 1
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 - Количество видеокарт

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

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

tariff: str - Тариф:
- start_1 - Start-1
- start_2 - Start-2
- start_3 - Start-3
- start_4 - Start-4
- tiny - Tiny
- small - Small
- medium - Medium
- large - Large
- xl16_big - XL16
- xl32_big - XL32
- xl64_big - XL64
- bitrix_s - Bitrix-S
- bitrix_m - Bitrix-M
- bitrix_l - Bitrix-L
- bitrix_xl - Bitrix-XL
- bitrix_xxl - Bitrix-XXL
- ultra16 - Ultra-16
- ultra32 - Ultra-32
- ultra64 - Ultra-64
- service1 - Service 1
disk_size: int - Размер диска
resource_name: str - Имя бекапа
backup_date: datetime - Дата бекапа

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

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 - Количество видеокарт

Коды ответов

Код	Описание
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 - Start-1
- start_2 - Start-2
- start_3 - Start-3
- start_4 - Start-4
- tiny - Tiny
- small - Small
- medium - Medium
- large - Large
- xl16_big - XL16
- xl32_big - XL32
- xl64_big - XL64
- bitrix_s - Bitrix-S
- bitrix_m - Bitrix-M
- bitrix_l - Bitrix-L
- bitrix_xl - Bitrix-XL
- bitrix_xxl - Bitrix-XXL
- ultra16 - Ultra-16
- ultra32 - Ultra-32
- ultra64 - Ultra-64
- service1 - Service 1

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

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 - Образ

Коды ответов

Код	Описание
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" 
    }'

Keys	Action
`?`	Open this help
`n`	Next page
`p`	Previous page
`s`	Search