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: