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

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

სარეზერვო ასლის შექმნა

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

URL: 

https://api.zomro.com/

მეთოდი: POST

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

სერვისისთვის სარეზერვო ასლის შექმნის მაგალითი

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

URL: 

https://api.zomro.com/

მეთოდი: POST

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

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

curl --location 'https://api.zomro.com/' \
--form 'func="instances.fleio_bckps.edit"' \
--form 'auth="d3ec30e337e01078a1d185cc"' \
--form 'out="json"' \
--form 'sok="ok"' \
--form 'plid="5203773"' \
--form 'name="MyBackup"'

მოთხოვნის შესრულების შემდეგ, ვხედავთ, რომ სარეზერვო ასლი შექმნის პროცესშია. როგორც ვხედავთ, backup-ის მნიშვნელობა არის Saving:

​​​​​​​

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

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

როგორ მივიღოთ სარეზერვო ასლების სია API-ის მეშვეობით

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

 URL: 

https://api.zomro.com/

მეთოდი: POST

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

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

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

curl --location 'https://api.zomro.com/' \
--form 'func="instances.fleio_bckps"' \
--form 'auth="8409b4eea786e3cad35eacf7"' \
--form 'out="json"' \
--form 'elid="5203773"'

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

{
    "doc": {
        ...
        "elem": [
            {
                "architecture": {
                    "$": "x86_64"
                },
                "backup_type": {
                    "$": "manual"
                },
                "createdate": {
                    "$": "2024-07-23"
                },
                "disk_format": {
                    "$": "qcow2"
                },
                "fleio_id": {
                    "$": "b26c0f34-48b2-4cb2-b4eb-388eac959df6"
                },
                "fleio_status": {
                    "$": "Active"
                },
                "hypervisor_type": {
                    "$": "any_hypervisor"
                },
                "id": {
                    "$": "5203980"
                },
                "image_size": {
                    "$": "3"
                },
                "item_real_status": {
                    "$": "2"
                },
                "min_disk": {
                    "$": "20"
                },
                "min_ram": {
                    "$": "0"
                },
                "name": {
                    "$": "MyBackup"
                },
                "os_distro": {
                    "$": "Ubuntu"
                },
                "os_version": {
                    "$": "22.04 x64"
                },
                "protected": {
                    "$": "off"
                },
                "region": {
                    "$": "Netherlands-2"
                },
                "visibility": {
                    "$": "private"
                }
            }
        ],
    }
}

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

doc.elem.[]

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

 როგორ წავშალოთ სარეზერვო ასლი

​​​​​​​

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

 URL: 

https://api.zomro.com/

მეთოდი: POST

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

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

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

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

​​​​​​​

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

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

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