opened image

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

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

 

Rescue пайдалану

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

 

URL: 

https://api.zomro.com/

Әдіс: POST

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

ПараметрМәннің мысалыМіндетті параметрМәннің сипаттамасы
funcinstances.fleio.rescueИәBoot from ISO пайдалану функциясы
auth21fc199...c43f71ЖоқСессия токені. Бұл авторизацияның бір нұсқасы. Қосымша нұсқалар туралы толығырақ мұнда сипатталған
outjsonИәКүтілетін жауап түрі
sokokИәОперацияны растау
elid5203773ИәInstance ID
select_bootf8f2573f-56c4-44c5-8469-84eee4aa64e7ИәПайдалануды жоспарлаған образдың UUID
passwordMyPassword1ЖоқRescue режимінде серверге кіру паролі. Серверге кіру үшін орнату ұсынылады
zonepubИәСурет орналасқан аймақ түрі. Қол жетімді параметрлер: «own», «pub».

 

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

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

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

 

URL: 

https://api.zomro.com/

 

Әдіс: POST

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

ПараметрМән
funcinstances.fleio.rescue
auth21fc199...c43f71
outjson
sokok
elid5203773
select_boot_from_isof8f2573f-56c4-44c5-8469-84eee4aa64e7
zonepub
passwordMyPassword1

 

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

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.[]

 

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

UUIDImage атауы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-6af546bebde6fooCentos 9 x64own

 

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

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

 

URL: 

https://api.zomro.com/

Әдіс: POST

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

ПараметрМәннің мысалыМіндетті параметрМәннің сипаттамасы
funcinstances.fleio.unrescueИәRescue режимінен шығу функциясы
auth21fc199...c43f71ЖоқСессия токені. Бұл авторизацияның бір нұсқасы. Қосымша нұсқалар туралы толығырақ мұнда сипатталған
outjsonИәКүтілетін жауап түрі
elid5203773Иә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 өнімдерімен өзара әрекеттесу үшін пайдалы болуы мүмкін мақалаларды оқуды ұсынамыз: