API - ურთიერთქმედება Boot From ISO-თან

ამ სტატიაში აღწერილია, როგორ განახორციელოთ Boot from ISO ოპერაცია API-ის დახმარებით.

Boot from ISO-ის გამოყენება

იმისათვის, რომ დაიწყოთ Boot From ISO პროცესი instance-ისთვის, ვასრულებთ შემდეგი ფორმატის მოთხოვნას:

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 რეჟიმში არჩეული გამოსახულებიდან. მაგალითად, შევასრულოთ შემდეგი მოთხოვნა, მაგრამ გადაცემული პარამეტრის «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

Image მოდიფიკატორით «pub» ხელმისაწვდომია ყველა მომხმარებლისთვის. ხოლო «own» - ხელმისაწვდომია მხოლოდ გამოსახულების მფლობელისთვის.

«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

მაგალითისთვის, გამოვრთოთ «Boot From ISO» რეჟიმი Instance-ისთვის ID 5203773.

ვცადოთ შემდეგი მოთხოვნის შესრულება კონსოლიდან:

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

მოთხოვნის შესრულების შემდეგ, ვხედავთ, რომ სერვისი აქტიურია:

ასევე გთავაზობთ შეისწავლოთ სტატიები, რომლებიც შეიძლება სასარგებლო იყოს Cloud VPS პროდუქტებთან API-ის დახმარებით ურთიერთობისთვის: