API - ურთიერთქმედება Snapshots-თან

ამ დოკუმენტში აღწერილია snapshots-ის შექმნის, დათვალიერების და წაშლის პროცესი instance-ისთვის Zomro სერვისის API-ის გამოყენებით. მოყვანილი მოთხოვნების მაგალითები დაგეხმარებათ სწრაფად გაერკვიოთ ძირითად ოპერაციებში, რომლებიც საჭიროა snapshots-ის მართვისთვის API-ის მეშვეობით.

snapshots-ის შექმნა

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

URL: 

https://api.zomro.com/

მეთოდი: POST

მოთხოვნის სხეული (Form-data):

snapshots-ის შექმნის მაგალითი სერვისისთვის

მაგალითისთვის, გამოვიყენოთ სერვისი:

URL: 

https://api.zomro.com/

მეთოდი: POST

მოთხოვნის სხეული (Form-data):

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

curl --location 'https://api.zomro.com/' \
--form 'func="instances.snapshots.edit"' \
--form 'auth="5acd1215da7a09eaae215987"' \
--form 'out="json"' \
--form 'sok="ok"' \
--form 'plid="5203773"' \
--form 'name="MySnapshot"'

მოთხოვნის შესრულების შემდეგ, ვხედავთ, რომ snapshots შექმნის პროცესშია. ამ ინფორმაციას ვიღებთ Status ველიდან, რომელიც აქვს მნიშვნელობა Saving:

რეზერვული ასლის შექმნის დასრულების შემდეგ, რეზერვული ასლის სტატუსი შეიცვლება Saving-დან Active-ზე:

როგორც ვხედავთ, snapshot-ის სტატუსი არის Active.

როგორ მივიღოთ snapshots-ის სია

ასევე, API-ის მეშვეობით შესაძლებელია snapshots-ის სიის მიღება. ამისთვის შეასრულეთ შემდეგი ფორმატის მოთხოვნა:

 URL: 

https://api.zomro.com/

მეთოდი: POST

მოთხოვნის სხეული (Form-data):

მაგალითისთვის, ვცადოთ snapshots-ის მიღება სერვისისთვის 5203773. წინა ნაბიჯზე, შევქმენით 1 snapshot. ვცადოთ მისი მიღება.

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

curl --location 'https://api.zomro.com/' \
--form 'func="instances.snapshots"' \
--form 'auth="9046d78a8fda29dda83d42dd"' \
--form 'out="json"' \
--form 'elid="5203773"'

ვიღებთ შემდეგ შედეგს:

{
    "doc": {
        ...
        "elem": [
            {
                "architecture": {
                    "$": "x86_64"
                },
                "createdate": {
                    "$": "2024-07-23"
                },
                "disk_format": {
                    "$": "qcow2"
                },
                "fleio_id": {
                    "$": "afd72725-81aa-43ad-984c-a3f3a05b4b84"
                },
                "fleio_status": {
                    "$": "Active"
                },
                "hypervisor_type": {
                    "$": "any_hypervisor"
                },
                "id": {
                    "$": "5204214"
                },
                "image_size": {         
                    "$": "3"
                },
                "item_real_status": {
                    "$": "2"
                },
                "min_disk": {
                    "$": "20"
                },
                "min_ram": {
                    "$": "0"
                },
                "name": {
                    "$": "MySnapshot"
                },
                "os_distro": {
                    "$": "Ubuntu"
                },
                "os_version": {
                    "$": "22.04 x64"
                },
                "protected": {
                    "$": "off"
                },
                "region": {
                    "$": "Netherlands-2"
                },
                "visibility": {
                    "$": "private"
                }
            }
        ],
    }
}

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

doc.elem.[]

ამ პასუხიდან, ვიღებთ შემდეგ მონაცემებს:

snapshot-ის წასაშლელად შეასრულეთ შემდეგი მოთხოვნა:

 URL: 

https://api.zomro.com/

მეთოდი: POST

მოთხოვნის სხეული (Form-data):

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

curl --location 'https://api.zomro.com/' \
--form 'func="image.delete"' \
--form 'auth="9046d78a8fda29dda83d42dd"' \
--form 'out="json"' \
--form 'sok="ok"' \
--form 'plid="5203773"' \
--form 'elname="5204214"' \
--form 'elid="5204214"'

მოთხოვნის შესრულების შემდეგ, შედეგის შემოწმება შესაძლებელია ფუნქციის «instances.fleio_bckps» გამოყენებით, ან ვებ ინტერფეისის მეშვეობით:

როგორც ხედავთ, snapshot წარმატებით წაიშალა.

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

• API - სერვისის შექმნა
• API - ხელმისაწვდომი ტარიფების და მათი პარამეტრების შესახებ ინფორმაციის მიღება
• API - ოპერაცია Start & Stop
• API - ოპერაცია Reboot
• API - ოპერაცია Rebuild
• API - ოპერაცია Delete
• API - Image-თან ურთიერთობა
• API - Backup Schedule-თან ურთიერთობა
• API - Rescue-თან ურთიერთობა
• API - Backup-თან ურთიერთობა
• API - Boot From ISO-თან ურთიერთობა