Для запуска операции Rebuild через API необходимо использовать специфическую функцию и передать необходимые параметры запроса. Ниже приведены детали запроса, включая URL, метод и обязательные параметры, которые требуется указать для успешного выполнения операции.
Для запуска операции Rebuild, используем следующую функцию.
URL:
https://api.zomro.com/
Метод: POST
Тело запроса(Form-data):
| Параметр | Пример значения | Обязательный параметр | Описание значения |
| func | instances.fleio.rebuild | Да | Функция, для запуска выполнения rebuild сервера |
| auth | 21fc199...c43f71 | Нет | Токен сессии. Это один из вариантов авторизации. Подробнее, какие еще есть варианты, описаны здесь |
| out | json | Да | Тип ответа, который ожидать |
| sok | ok | Да | Подтверждение операции |
| elid | 5113119 | Да | ID услуги, над которой нужно выполнить операцию |
| zone | image | Да | Из какого раздела использовать образы для переустановки ОС |
| select_rebuild | 18d0ee2e-4d57-4f40-9b56-03c1773b5831 | Да | UID операционной системы, на которую нужно переустановить instance. UID операционной системы, можно получить из функции v2.instances.order.pricelist. Подробнее, как пользоваться, описано здесь |
| enablessh | off | Да | Использовать ssh ключ или нет. Может принимать значения off или on. |
| password | Mypassword1 | Нет | Пароль доступа к серверу. В случае с Linux, пароль для пользователя root. В случае Windows - пароль пользователя Administrator. Не нужно передавать, если параметр enablessh=on. Также, пароль должен содержать хотя бы 1 символ большой английской буквы, 1 цифровой символ, минимальное количество символов 8. |
| ssh_keys | 490 | Нет |
ID SSH ключа, который нужно добавить к серверу после установки ОС. Не нужно передавать, если параметр use_ssh_key=off. |
Пример выполнения rebuild
Для примера, используем услугу с Ubuntu 20.04, и выполним rebuild на AlmaLinux 8, и установим пароль для пользователя root - Mypassword1.
URL:
https://api.zomro.com/
Метод: POST
Тело запроса(Form-data):
| Параметр | Значение |
| func | instances.fleio.rebuild |
| auth | 21fc199...c43f71 |
| out | json |
| sok | ok |
| elid | 5113119 |
| zone | image |
| select_rebuild | 18d0ee2e-4d57-4f40-9b56-03c1773b5831 |
| enablessh | off |
| password | Mypassword1 |
Вот пример запроса, который можно выполнить из консоли:
curl --location 'https://api.zomro.com/' \
--form 'func="instances.fleio.rebuild"' \
--form 'auth="f1662dcabc6b96c85be3af64"' \
--form 'elid="5113119"' \
--form 'zone="image"' \
--form 'select_rebuild="18d0ee2e-4d57-4f40-9b56-03c1773b5831"' \
--form 'enablessh="off"' \
--form 'password="Mypassword12"' \
--form 'sok="ok"' \
--form 'out="json"'
Данная операция занимает некоторое время, так как во время операции осуществляется переустановка операционной системы. В зависимости от ОС, время ожидания может различаться.
После выполнения запроса, можем убедиться, что операционная система переустановлена в личном кабинете или с помощью API
Результат операции также можно увидеть в истории выполнения операций в графическом интерфейсе.
Как видим, операция выполнена успешно.
Также предлагаем изучить статьи, которые могут быть в полезными для взаимодействия с продуктами Cloud VPS с помощью API: