API - Rescue-пен өзара әрекеттесу

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

Rescue пайдалану

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

URL:

https://api.zomro.com/

Әдіс: POST

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

Параметр	Мәннің мысалы	Міндетті параметр	Мәннің сипаттамасы
func	instances.fleio.rescue	Иә	Boot from ISO пайдалану функциясы
auth	21fc199...c43f71	Жоқ	Сессия токені. Бұл авторизацияның бір нұсқасы. Қосымша нұсқалар туралы толығырақ мұнда сипатталған
out	json	Иә	Күтілетін жауап түрі
sok	ok	Иә	Операцияны растау
elid	5203773	Иә	Instance ID
select_boot	f8f2573f-56c4-44c5-8469-84eee4aa64e7	Иә	Пайдалануды жоспарлаған образдың UUID
password	MyPassword1	Жоқ	Rescue режимінде серверге кіру паролі. Серверге кіру үшін орнату ұсынылады
zone	pub	Иә	Сурет орналасқан аймақ түрі. Қол жетімді параметрлер: «own», «pub».

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

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

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

URL:

https://api.zomro.com/

Әдіс: POST

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

Параметр	Мән
func	instances.fleio.rescue
auth	21fc199...c43f71
out	json
sok	ok
elid	5203773
select_boot_from_iso	f8f2573f-56c4-44c5-8469-84eee4aa64e7
zone	pub
password	MyPassword1

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

curl --location 'https://api.zomro.com/' \
--form 'func="instances.fleio.rescue"' \
--form 'auth="43137b5f35a6ba4ee01f4a4e"' \
--form 'out="json"' \
--form 'elid="5203773"' \
--form 'sok="ok"' \
--form 'select_boot="f8f2573f-56c4-44c5-8469-84eee4aa64e7"' \
--form 'password="MyPassword1"' \
--form 'zone="pub"'

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

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

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

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

{
    "doc": {
        ...
        "slist": [
            {
                "$name": "zone",
                "val": [
                    {
                        "$key": "pub",
                        "$": "pub"
                    },
                    {
                        "$key": "own",
                        "$": "own"
                    }
                ]
            },
            {
                "$name": "select_boot",
                "val": [
                    {
                        "$depend": "pub",
                        "$key": "f8f2573f-56c4-44c5-8469-84eee4aa64e7",
                        "$": "Ubuntu 22.04"
                    },
                    {
                        "$depend": "pub",
                        "$key": "0bf4deb2-855c-4863-8518-6006d804adbb",
                        "$": "Debian 10"
                    },
                    {
                        "$depend": "pub",
                        "$key": "18d0ee2e-4d57-4f40-9b56-03c1773b5831",
                        "$": "AlmaLinux 8"
                    },
                    {
                        "$depend": "pub",
                        "$key": "1d9dda4c-34b0-4304-a90a-8f3018722fa2",
                        "$": "Rocky-Linux-8"
                    },
                    {
                        "$depend": "pub",
                        "$key": "2af0af94-0e6e-4ef3-8837-d41fdbfa3564",
                        "$": "Windows Server 2016"
                    },
                    {
                        "$depend": "pub",
                        "$key": "3010ae60-0185-4021-98da-f50013147ebd",
                        "$": "Debian 11"
                    },
                    {
                        "$depend": "pub",
                        "$key": "479c96f1-ccc6-47a2-952c-c9e3bbdc8d07",
                        "$": "Ubuntu 20.04"
                    },
                    {
                        "$depend": "pub",
                        "$key": "5da4ad83-45f6-4c0e-9a7e-7a7c18b2be6c",
                        "$": "AlmaLinux 9"
                    },
                    {
                        "$depend": "pub",
                        "$key": "7d7911e3-7178-4f36-a308-d841db5fe654",
                        "$": "CentOS Stream 9"
                    },
                    {
                        "$depend": "pub",
                        "$key": "92fabac2-69cc-46ad-8439-c377e0c90632",
                        "$": "Ubuntu 23.04"
                    },
                    {
                        "$depend": "pub",
                        "$key": "93878ba5-6b9e-4924-a4be-34edb623f808",
                        "$": "Debian 12"
                    },
                    {
                        "$depend": "pub",
                        "$key": "a8b7bcb3-6698-4264-b413-f2b866a46a70",
                        "$": "Rocky-Linux-9"
                    },
                    {
                        "$depend": "pub",
                        "$key": "b10434c0-d839-428f-a919-cac733fd6552",
                        "$": "Windows Server 2019"
                    },
                    {
                        "$depend": "pub",
                        "$key": "bda2467e-e192-4e4e-becc-cda2e71b9767",
                        "$": "Windows Server 2022"
                    },
                    {
                        "$depend": "own",
                        "$name": "foo",
                        "$key": "a9e7c223-5f11-4546-a298-6af546bebde6",
                        "$": "Centos 9 x64"
                    },
                ]
            }
        ],
    
    }
}

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

doc.slist.[]

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

UUID	Image атауы	OS атауы	Көріну аймағы
f8f2573f-56c4-44c5-8469-84eee4aa64e7	-	Ubuntu 22.04	pub
0bf4deb2-855c-4863-8518-6006d804adbb	-	Debian 10	pub
18d0ee2e-4d57-4f40-9b56-03c1773b5831	-	AlmaLinux 8	pub
1d9dda4c-34b0-4304-a90a-8f3018722fa2	-	Rocky-Linux-8	pub
2af0af94-0e6e-4ef3-8837-d41fdbfa3564	-	Windows Server 2016	pub
3010ae60-0185-4021-98da-f50013147ebd	-	Debian 11	pub
479c96f1-ccc6-47a2-952c-c9e3bbdc8d07	-	Ubuntu 20.04	pub
5da4ad83-45f6-4c0e-9a7e-7a7c18b2be6c	-	AlmaLinux 9	pub
7d7911e3-7178-4f36-a308-d841db5fe654	-	CentOS Stream 9	pub
92fabac2-69cc-46ad-8439-c377e0c90632	-	Ubuntu23.04	pub
93878ba5-6b9e-4924-a4be-34edb623f808	-	Debian 12	pub
a8b7bcb3-6698-4264-b413-f2b866a46a70	-	Rocky-Linux-9	pub
b10434c0-d839-428f-a919-cac733fd6552	-	Windows Server 2019	pub
bda2467e-e192-4e4e-becc-cda2e71b9767	-	Windows Server 2022	pub
a9e7c223-5f11-4546-a298-6af546bebde6	foo	Centos 9 x64	own

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

Сондай-ақ, «Rescue» режимінен шығу үшін келесі форматтағы API сұранысын орындаймыз:

URL:

https://api.zomro.com/

Әдіс: POST

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

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

«Rescue» режимін қалай өшіруге болады

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

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

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

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

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