Бұл мақалада 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 өнімдерімен өзара әрекеттесу үшін пайдалы болуы мүмкін мақалаларды оқуды ұсынамыз:
- API - Қызметті құру
- API - Қол жетімді тарифтер мен олардың параметрлері туралы ақпарат алу
- API - Start & Stop операциясы
- API - Reboot операциясы
- API - Rebuild операциясы
- API - Delete операциясы
- API - Image-пен өзара әрекеттесу
- API - Backup Schedule-пен өзара әрекеттесу
- API - Backup-пен өзара әрекеттесу
- API - Snapshots-пен өзара әрекеттесу
- API - Boot From ISO-пен өзара әрекеттесу