API - Operacija Rebuild

Norint paleisti Rebuild operaciją per API, būtina naudoti specifinę funkciją ir perduoti reikiamus užklausos parametrus. Žemiau pateikiamos užklausos detalės, įskaitant URL, metodą ir privalomus parametrus, kuriuos reikia nurodyti, kad operacija būtų sėkmingai atlikta.

Norint paleisti Rebuild operaciją, naudojame šią funkciją.

URL:

https://api.zomro.com/

Metodas: POST

Užklausos kūnas (Form-data):

Parametras	Pavyzdinė reikšmė	Privalomas parametras	Reikšmės aprašymas
func	instances.fleio.rebuild	Taip	Funkcija, skirta paleisti serverio rebuild
auth	21fc199...c43f71	Ne	Sesijos žetonas. Tai vienas iš autorizacijos būdų. Daugiau apie kitus būdus aprašyta čia
out	json	Taip	Atsakymo tipas, kurio tikėtis
sok	ok	Taip	Operacijos patvirtinimas
elid	5113119	Taip	Paslaugos ID, kuriai reikia atlikti operaciją
zone	image	Taip	Iš kurio skyriaus naudoti OS atvaizdus perinstaliavimui
select_rebuild	18d0ee2e-4d57-4f40-9b56-03c1773b5831	Taip	OS UID, į kurią reikia perinstaliuoti instance. UID operacinės sistemos galima gauti iš funkcijos v2.instances.order.pricelist. Daugiau apie tai, kaip naudotis, aprašyta čia
enablessh	off	Taip	Naudoti ssh raktą ar ne. Gali būti reikšmės off arba on.
password	Mypassword1	Ne	Prieigos prie serverio slaptažodis. Linux atveju - root vartotojo slaptažodis. Windows atveju - Administrator vartotojo slaptažodis. Nereikia perduoti, jei parametras enablessh=on. Be to, slaptažodis turi turėti bent 1 didžiąją raidę, 1 skaitmenį, minimalus simbolių skaičius - 8.
ssh_keys	490	Ne	SSH rakto ID, kurį reikia pridėti prie serverio po OS įdiegimo. Nereikia perduoti, jei parametras use_ssh_key=off. SSH rakto ID galima gauti iš funkcijos v2.instances.order.pricelist. Daugiau apie tai, kaip naudotis, aprašyta čia

Rebuild vykdymo pavyzdys

Pavyzdžiui, naudojame paslaugą su Ubuntu 20.04 ir atliekame rebuild į AlmaLinux 8, nustatome root vartotojo slaptažodį - Mypassword1.

URL:

https://api.zomro.com/

Metodas: POST

Užklausos kūnas (Form-data):

Parametras	Reikšmė
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

Štai užklausos pavyzdys, kurį galima atlikti iš konsolės:

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"'

Ši operacija užtrunka šiek tiek laiko, nes operacijos metu atliekamas operacinės sistemos perinstaliavimas. Priklausomai nuo OS, laukimo laikas gali skirtis.

Po užklausos vykdymo galime įsitikinti, kad operacinė sistema perinstaliuota asmeninėje paskyroje arba naudojant API

Operacijos rezultatus taip pat galima pamatyti operacijų vykdymo istorijoje grafinėje sąsajoje.

Kaip matome, operacija atlikta sėkmingai.

Taip pat siūlome susipažinti su straipsniais, kurie gali būti naudingi sąveikai su Cloud VPS produktais naudojant API: