Перейти к содержанию

Облачные VDS

Данные по основному диску

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

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

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

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

Коды ответов

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

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

Основной диск

  • created: datetime – Дата создания
  • updated: datetime – Дата изменения
  • id: int – Идентификатор основного диска
  • uid: str – Уникальный идентификатор основного диска, например, vl_54d42b8e
  • name: str – Имя основного диска
  • size: int – Размер основного диска
  • type: str – Тип диска:
    • Normal – SSD
    • Fast – NVME
    • Slow – SAS
  • has_backups: bool – Наличие бекапов
  • is_backup_enabled: bool – Подключена ли услуга резервного копирования

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

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

Изменение размера основного диска

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

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

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

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

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

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

  • size: 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}/disk/resize/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY" \
    --header "Content-Type: application/json" \
    --data '{
          "size": 15 
    }'

Изменение типа основного диска

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

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

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

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

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

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

  • type: str – Тип диска:
    • Slow – Медленные диски
    • Normal – Стандартные диски
    • Fast – Быстрые диски

Коды ответов

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

Включение/выключение бекапов для основного диска

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

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

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

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

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

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

  • is_backup_enabled: 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}/disk/change-backup/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"

Изменение имени основного диска

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

Список дополнительных дисков

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

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

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

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

Коды ответов

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

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

  • count: int – Количество элементов
  • entities – Список дополнительных дисков
    • created: datetime – Дата создания
    • updated: datetime – Дата изменения
    • id: int – Идентификатор дополнительного диска
    • uid: str – Уникальный идентификатор дополнительного диска, например, vl_54d42b8e
    • name: str – Имя дополнительного диска
    • size: int – Размер дополнительного диска
    • type: str – Тип диска:
      • Normal – SSD
      • Fast – NVME
      • Slow – SAS
    • has_backups: bool – Наличие бекапов
    • is_backup_enabled: bool – Подключена ли услуга резервного копирования

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

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

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

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

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

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

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

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

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

  • size: int – Размер диска

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

  • is_backup_enabled: bool – Включить/выключить бекапы

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

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

  • size: int – Размер диска
  • resource_name: str – Имя бекапа
  • backup_date: datetime64 – Дата бекапа

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

  • is_backup_enabled: 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}/volumes/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"

Изменение размера дополнительного диска

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

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

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

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

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

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

  • size: 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}/volumes/{volume_id}/resize/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY" \
    --header "Content-Type: application/json" \
    --data '{
          "size": 15 
    }'

Изменение типа дополнительного диска

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

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

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

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

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

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

  • type: str – Тип диска:
    • Slow – Медленные диски
    • Normal – Стандартные диски
    • Fast – Быстрые диски

Коды ответов

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

Включение/выключение бекапов для дополнительного диска

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

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

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

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

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

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

  • is_backup_enabled: 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}/volumes/{volume_id}/change-backup/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"

Изменение имени дополнительного диска

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

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

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

  • id: int – ID виртуальной машины
  • volume_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}/volumes/{volume_id}/change-name/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"

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

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

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

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

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

Коды ответов

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

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

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

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

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

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