API - Операция Rebuild

Для запуска операции 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. ID SSH ключа, можно получить из функции v2.instances.order.pricelist. Подробнее, как пользоваться, описано здесь

Пример выполнения 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: