Cloud 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 - Дата и время в формате: 2020-11-02T04:26:40
  • 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 - Дата и время в формате: 2020-11-02T04:26:40
  • 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 - Дата и время в формате: 2020-11-02T04:26:40
  • 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 - Дата и время в формате: 2020-11-02T04:26:40

Коды ответов

Код Описание
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 - Дата и время в формате: 2020-11-02T04:26:40

Коды ответов

Код Описание
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 - Дата и время в формате: 2020-11-02T04:26:40

Коды ответов

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