API - Sąveika su Boot From ISO

Šiame straipsnyje aprašyta, kaip atlikti operaciją Boot from ISO naudojant API.

Naudojimas Boot from ISO

Norėdami pradėti Boot From ISO procesą instance, atliekame užklausą tokio formato:

URL:

https://api.zomro.com/

Metodas: POST

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

Parametras	Reikšmės pavyzdys	Privalomas parametras	Reikšmės aprašymas
func	instances.fleio.boot_from_iso	Taip	Funkcija Boot from ISO naudojimui
auth	21fc199...c43f71	Ne	Sesijos tokenas. Tai vienas iš autorizacijos variantų. Daugiau apie kitus variantus aprašyta čia
out	json	Taip	Atsakymo tipas, kurio tikėtis
sok	ok	Taip	Operacijos patvirtinimas
elid	5203773	Taip	Instance ID
select_boot_from_iso	ffa4a7c1-9e36-49a1-8770-acfb2878141f	Taip	Vaizdo UUID, kurį planuojame naudoti. Rekomenduojama naudoti vaizdą su ISO disko tipu
zone	pub	Taip	Zonos tipas, kur yra vaizdas. Galimi parametrai: «own», «pub».

Pavyzdys, kaip instance pereina į Boot From ISO režimą

Pavyzdžiui, naudojame paslaugą:

ir įkeliame šį vaizdą:

URL:

https://api.zomro.com/

Metodas: POST

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

Parametras	Reikšmė
func	instances.fleio.boot_from_iso
auth	21fc199...c43f71
out	json
sok	ok
elid	5203773
select_boot_from_iso	ffa4a7c1-9e36-49a1-8770-acfb2878141f
zone	pub

Štai pavyzdys užklausos, kurią galima atlikti iš konsolės:

curl --location 'https://api.zomro.com/' \
--form 'func="instances.fleio.boot_from_iso"' \
--form 'auth="d22467cab40fedf7674da126"' \
--form 'out="json"' \
--form 'elid="5203773"' \
--form 'sok="ok"' \
--form 'select_boot_from_iso="ffa4a7c1-9e36-49a1-8770-acfb2878141f"' \
--form 'zone="pub"'

Po užklausos atlikimo matome, kad instance perėjo į «Boot from ISO» režimą. Tai patvirtina rezultatas nuotraukoje:

Taip pat, jei nepateikti parametro sok, bus atlikta užklausa peržiūros režimu. Atlikus šią užklausą, galima gauti prieinamus image, kad pereiti į boot from iso iš pasirinkto image. Pavyzdžiui, atliksime šią užklausą, bet be parametro «sok»:

curl --location 'https://api.zomro.com/' \
--form 'func="instances.fleio.boot_from_iso"' \
--form 'auth="d22467cab40fedf7674da126"' \
--form 'out="json"' \
--form 'elid="5203773"'

Gauname šį atsakymą:

{
    "doc": {
        ...
        "slist": [
            {
                "$name": "zone",
                "val": [
                    {
                        "$key": "own",
                        "$": "own"
                    },
                    {
                        "$key": "pub",
                        "$": "pub"
                    }
                ]
            },
            {
                "$name": "select_boot_from_iso",
                "val": [
                    {
                        "$depend": "own",
                        "$name": "myImage",
                        "$key": "35904b88-7c1f-47c6-911c-1198fbc6afeb",
                        "$": "Solaris "
                    },
                    {
                        "$depend": "own",
                        "$name": "boo",
                        "$key": "696c4ee2-6d19-4281-b301-599c220cd4f3",
                        "$": "AlmaLinux "
                    },
                    {
                        "$depend": "own",
                        "$name": "foo",
                        "$key": "5b71c86b-c384-4e6f-9fd8-3f22d000c2ff",
                        "$": "AlmaLinux "
                    },
                    {
                        "$depend": "pub",
                        "$key": "ffa4a7c1-9e36-49a1-8770-acfb2878141f",
                        "$": "[ISO] systemrescue-11.00-amd64"
                    }
                ]
            }
        ],
    
    }
}

Analizuodami šią atsakymo struktūrą, matome, kad mus dominančius duomenis galima rasti šioje hierarchijoje:

doc.slist.[]

Kaip matome, mums prieinami vaizdai:

UUID	Vaizdo pavadinimas	OS pavadinimas	Matomumo sritis
35904b88-7c1f-47c6-911c-1198fbc6afeb	myImage	Solaris	own
696c4ee2-6d19-4281-b301-599c220cd4f3	boo	AlmaLinux	own
5b71c86b-c384-4e6f-9fd8-3f22d000c2ff	foo	AlmaLinux	own
ffa4a7c1-9e36-49a1-8770-acfb2878141f	-	[ISO] systemrescue-11.00-amd64	pub

Vaizdas su prieigos modifikatoriumi «pub» yra prieinamas visiems vartotojams. Tačiau su «own» - prieinamas tik vaizdo savininkui.

Išėjimas iš «Boot From ISO» režimo

Taip pat, norėdami išeiti iš «Boot From ISO» režimo, atliekame šią API užklausą, tokio formato:

URL:

https://api.zomro.com/

Metodas: POST

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

Parametras	Reikšmės pavyzdys	Privalomas parametras	Reikšmės aprašymas
func	instances.fleio.unrescue	Taip	Funkcija, skirta išeiti iš «Boot from ISO» režimo
auth	21fc199...c43f71	Ne	Sesijos tokenas. Tai vienas iš autorizacijos variantų. Daugiau apie kitus variantus aprašyta čia
out	json	Taip	Atsakymo tipas, kurio tikėtis
elid	5203773	Taip	Instance ID

Pavyzdžiui, išjungsime «Boot From ISO» režimą instance su ID 5203773.

Pabandykime atlikti šią užklausą konsolėje:

curl --location 'https://api.zomro.com/' \
--form 'func="instances.fleio.unrescue"' \
--form 'auth="0b31d69ab7b7b4839dfd6506"' \
--form 'out="json"' \
--form 'elid="5203773"'

Po užklausos atlikimo matome, kad paslauga aktyvi:

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