Lai palaistu Rebuild operāciju caur API, nepieciešams izmantot specifisku funkciju un nodot nepieciešamos pieprasījuma parametrus. Zemāk ir sniegtas pieprasījuma detaļas, ieskaitot URL, metodi un obligātos parametrus, kas jānorāda, lai veiksmīgi izpildītu operāciju.
Lai palaistu Rebuild operāciju, izmantojam sekojošo funkciju.
URL:
https://api.zomro.com/
Metode: POST
Pieprasījuma ķermenis (Form-data):
Parametrs | Vērtības piemērs | Obligāts parametrs | Vērtības apraksts |
func | instances.fleio.rebuild | Jā | Funkcija, lai palaistu servera rebuild |
auth | 21fc199...c43f71 | Nē | Sesijas tokens. Tas ir viens no autorizācijas veidiem. Vairāk par citiem veidiem aprakstīts šeit |
out | json | Jā | Atbildes tips, kuru sagaidīt |
sok | ok | Jā | Operācijas apstiprinājums |
elid | 5113119 | Jā | Pakalpojuma ID, kuram jāveic operācija |
zone | image | Jā | No kuras sadaļas izmantot attēlus OS pārinstalēšanai |
select_rebuild | 18d0ee2e-4d57-4f40-9b56-03c1773b5831 | Jā | Operētājsistēmas UID, uz kuru jāveic instance pārinstalēšana. UID operētājsistēmas var iegūt no funkcijas v2.instances.order.pricelist. Vairāk par to, kā izmantot, aprakstīts šeit |
enablessh | off | Jā | Vai izmantot ssh atslēgu vai nē. Var pieņemt vērtības off vai on. |
password | Mypassword1 | Nē | Piekļuves parole serverim. Linux gadījumā - parole root lietotājam. Windows gadījumā - Administrator lietotāja parole. Nav nepieciešams nodot, ja parametrs enablessh=on. Parolei jābūt vismaz 1 lielajam angļu burtam, 1 ciparam, minimālais simbolu skaits - 8. |
ssh_keys | 490 | Nē | SSH atslēgas ID, kuru pievienot serverim pēc OS uzstādīšanas. Nav nepieciešams nodot, ja parametrs use_ssh_key=off. |
Rebuild izpildes piemērs
Piemēram, izmantojam pakalpojumu ar Ubuntu 20.04 un veicam rebuild uz AlmaLinux 8, un uzstādām paroli root lietotājam - Mypassword1.
URL:
https://api.zomro.com/
Metode: POST
Pieprasījuma ķermenis (Form-data):
Parametrs | Vērtība |
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 |
Šeit ir pieprasījuma piemērs, kuru var izpildīt no konsoles:
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"'
Šī operācija aizņem zināmu laiku, jo operācijas laikā tiek veikta operētājsistēmas pārinstalēšana. Atkarībā no OS, gaidīšanas laiks var atšķirties.
Pēc pieprasījuma izpildes, varam pārliecināties, ka operētājsistēma ir pārinstalēta personīgajā kabinetā vai izmantojot API
Operācijas rezultātu var redzēt arī operāciju vēsturē grafiskajā interfeisā.
Kā redzam, operācija veiksmīgi izpildīta.
Arī piedāvājam izpētīt rakstus, kas var būt noderīgi mijiedarbībai ar Cloud VPS produktiem, izmantojot API:
- API - Pakalpojuma izveide
- API - Informācijas iegūšana par pieejamajiem tarifiem un to parametriem
- API - Operācija Start & Stop
- API - Operācija Reboot
- API - Operācija Delete
- API - Mijiedarbība ar Backup Schedule
- API - Mijiedarbība ar Rescue
- API - Mijiedarbība ar Backup
- API - Mijiedarbība ar Snapshots
- API - Mijiedarbība ar Boot From ISO
- API - Mijiedarbība ar Image