Облачные VDS

• Список бекапов пользователя
• Список бекапов для всех ВМ
• Создание бекапа
• Список бекапов для ВМ
• Откат ВМ
• Список файлов из бекапа на ВМ
• Получение архива файлов с ВМ
• Список бекапов для дополнительного диска
• Откат дополнительного диска
• Список файлов из бекапа на дополнительном диске
• Получение архива файлов с дополнительного диска

Список бекапов пользователя

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

Коды ответов

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

---

Список бекапов для всех ВМ

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

Коды ответов

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

---

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

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

---

Список бекапов для ВМ

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

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

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

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

Коды ответов

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

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

• entities – Список бекапов
  • methods: dict – Список возможных методов восстановления
  • backup_date: datetime – Дата создания бекапа
  • resource_name: str – Имя ресурса для которого сделан бекап
  • resource_type: str – Тип ресурса для которого сделан бекап:
    • VM – Виртуальная машина
    • Disk – Основной диск
    • Volume – Дополнительный диск
  • virtual_size: int – Виртуальный размер

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

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

---

Откат ВМ

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

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

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

• date: datetime – Дата и время в формате: 2024-11-29T04:26:40.900150729
• 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}/backups/{date}/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"

---

Список файлов из бекапа на ВМ

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

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

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

• date: datetime – Дата и время в формате: 2024-11-29T04:26:40.900150729
• id: int – ID виртуальной машины

Коды ответов

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

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

Список файлов из бекапа

• files: List[str] – Список файлов

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

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

---

Получение архива файлов с ВМ

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

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

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

• date: datetime – Дата и время в формате: 2024-11-29T04:26:40.900150729
• 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}/backups/{date}/files/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"

---

Список бекапов для дополнительного диска

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

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

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

• id: int – ID виртуальной машины
• volume_id: int – ID дополнительного диска

Коды ответов

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

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

• entities – Список бекапов
  • methods: dict – Список возможных методов восстановления
  • backup_date: datetime – Дата создания бекапа
  • resource_name: str – Имя ресурса для которого сделан бекап
  • resource_type: str – Тип ресурса для которого сделан бекап:
    • VM – Виртуальная машина
    • Disk – Основной диск
    • Volume – Дополнительный диск
  • virtual_size: int – Виртуальный размер

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

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

---

Откат дополнительного диска

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

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

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

• id: int – ID виртуальной машины
• volume_id: int – ID дополнительного диска
• date: datetime – Дата и время в формате: 2024-11-29T04:26:40.900150729

Коды ответов

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

---

Список файлов из бекапа на дополнительном диске

URL: /api/v1/cloud/vms/{id}/volumes/{volume_id}/backups/{date}/files/
Метод: GET
Результат: JSON

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

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

• id: int – ID виртуальной машины
• volume_id: int – ID дополнительного диска
• date: datetime – Дата и время в формате: 2024-11-29T04:26:40.900150729

Коды ответов

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

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

Список файлов из бекапа

• files: List[str] – Список файлов

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

curl --request GET 'https://api-ms.netangels.ru/api/v1/cloud/vms/{id}/volumes/{volume_id}/backups/{date}/files/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"

---

Получение архива файлов с дополнительного диска

URL: /api/v1/cloud/vms/{id}/volumes/{volume_id}/backups/{date}/files/
Метод: POST
Результат: JSON

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

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

• id: int – ID виртуальной машины
• volume_id: int – ID дополнительного диска
• date: datetime – Дата и время в формате: 2024-11-29T04:26:40.900150729

Коды ответов

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