API - Boot From ISO арқылы өзара әрекеттесу

Бұл мақалада API арқылы Boot from ISO операциясын қалай жүзеге асыру керектігі сипатталған.

Boot from ISO пайдалану

Instance үшін Boot From ISO процесін бастау үшін келесі форматтағы сұранысты орындаймыз:

URL:

https://api.zomro.com/

Әдіс: POST

Сұраныс денесі (Form-data):

Параметр	Мәннің мысалы	Міндетті параметр	Мәннің сипаттамасы
func	instances.fleio.boot_from_iso	Иә	Boot from ISO пайдалану функциясы
auth	21fc199...c43f71	Жоқ	Сессия токені. Бұл авторизацияның бір нұсқасы. Қосымша нұсқалар туралы толығырақ мұнда сипатталған
out	json	Иә	Күтілетін жауап түрі
sok	ok	Иә	Операцияны растау
elid	5203773	Иә	Instance ID
select_boot_from_iso	ffa4a7c1-9e36-49a1-8770-acfb2878141f	Иә	Пайдалануды жоспарлаған образдың UUID. ISO диск түріндегі образды пайдалану ұсынылады
zone	pub	Иә	Образ орналасқан аймақ түрі. Қол жетімді параметрлер: «own», «pub».

Instance-ді Boot From ISO режиміне ауыстыру мысалы

Мысал ретінде келесі қызметті пайдаланамыз:

және келесі образды жүктейміз:

URL:

https://api.zomro.com/

Әдіс: POST

Сұраныс денесі (Form-data):

Параметр	Мән
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

Міне, консольден орындауға болатын сұраныс мысалы:

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

Сұранысты орындағаннан кейін, instance «Boot from ISO» режиміне ауысқанын көреміз. Мұны растау үшін нәтижені суреттен көруге болады:

Сонымен қатар, егер sok параметрін бермесек, сұраныс алдын ала қарау режимінде орындалады. Бұл сұранысты орындау арқылы boot from iso режиміне өту үшін қол жетімді image-лерді алуға болады. Мысал ретінде, келесі сұранысты sok параметрін бермей орындаймыз:

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

Келесі жауапты аламыз:

{
    "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"
                    }
                ]
            }
        ],
    
    }
}

Бұл жауап құрылымын талдай отырып, қажетті деректер келесі деңгейде орналасқанын көреміз:

doc.slist.[]

Көріп отырғанымыздай, бізге қол жетімді образдар:

UUID	Image атауы	OS атауы	Көріну аймағы
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

Қол жетімділік модификаторы «pub» бар image барлық пайдаланушыларға қол жетімді. Ал «own» - тек image иесіне қол жетімді.

«Boot From ISO» режимінен шығу

«Boot From ISO» режимінен шығу үшін келесі форматтағы API сұранысын орындаймыз:

URL:

https://api.zomro.com/

Әдіс: POST

Сұраныс денесі (Form-data):

Параметр	Мәннің мысалы	Міндетті параметр	Мәннің сипаттамасы
func	instances.fleio.unrescue	Иә	«Boot from ISO» режимінен шығу функциясы
auth	21fc199...c43f71	Жоқ	Сессия токені. Бұл авторизацияның бір нұсқасы. Қосымша нұсқалар туралы толығырақ мұнда сипатталған
out	json	Иә	Күтілетін жауап түрі
elid	5203773	Иә	Instance ID

Мысал ретінде, 5203773 ID бар Instance үшін «Boot From ISO» режимін өшіреміз.

Консольде келесі сұранысты орындап көрейік:

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

Сұранысты орындағаннан кейін, қызметтің белсенді екенін көреміз:

Сондай-ақ, API арқылы Cloud VPS өнімдерімен өзара әрекеттесу үшін пайдалы болуы мүмкін мақалаларды оқуды ұсынамыз: