API - Interakcja z Backup

W tym dokumencie opisano proces tworzenia, przeglądania i usuwania kopii zapasowych dla instancji za pomocą API serwisu Zomro. Przykłady zapytań pomogą Ci szybko zrozumieć podstawowe operacje niezbędne do zarządzania kopiami zapasowymi przez API.

Tworzenie kopii zapasowej

Aby utworzyć kopię zapasową, wykonaj następujące zapytanie:

URL: 

https://api.zomro.com/

Metoda: POST

Treść zapytania (Form-data):

Przykład tworzenia kopii zapasowej dla usługi

Na przykład, użyjemy usługi:

URL: 

https://api.zomro.com/

Metoda: POST

Treść zapytania (Form-data):

Oto przykład zapytania, które można wykonać z konsoli:

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"'

Po wykonaniu zapytania, widzimy, że kopia zapasowa jest w trakcie tworzenia. Jak widać, backup ma wartość Saving:

​​​​​​​

Po zakończeniu tworzenia kopii zapasowej, status kopii zapasowej zmieni się z Saving na Active:

Jak widać, status usługi jest Active.

Jak uzyskać listę kopii zapasowych za pomocą API

Również za pomocą API można uzyskać listę kopii zapasowych. W tym celu wykonujemy następujące zapytanie:

 URL: 

https://api.zomro.com/

Metoda: POST

Treść zapytania (Form-data):

Na przykład, spróbujemy uzyskać kopie zapasowe dla usługi 5203773. W poprzednim kroku utworzyliśmy 1 kopię zapasową. Spróbujmy ją uzyskać.

Spróbujmy wykonać następujące zapytanie w konsoli:

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

Otrzymujemy następujący wynik:

{
    "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"
                }
            }
        ],
    }
}

Interesują nas dane, które otrzymujemy w następującej strukturze:​​​​​​​

doc.elem.[]

Z tej odpowiedzi otrzymujemy następujące dane:

Jak usunąć kopię zapasową

​​​​​​​

Aby usunąć kopię zapasową, wykonaj następujące zapytanie:

 URL: 

https://api.zomro.com/

Metoda: POST

Treść zapytania (Form-data):

Spróbujmy wykonać następujące zapytanie w konsoli:

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"'

Po wykonaniu zapytania, wynik można sprawdzić za pomocą funkcji „instances.fleio_bckps” lub przeglądając za pomocą interfejsu webowego:

​​​​​​​

Jak możemy zobaczyć, kopia zapasowa została pomyślnie usunięta. 

Również proponujemy zapoznać się z artykułami, które mogą być przydatne do interakcji z produktami Cloud VPS za pomocą API:

• API - Tworzenie usługi
• API - Uzyskiwanie informacji o dostępnych taryfach i ich parametrach
• API - Operacja Start & Stop
• API - Operacja Reboot
• API - Operacja Rebuild
• API - Operacja Delete
• API - Interakcja z Image
• API - Interakcja z Backup Schedule
• API - Interakcja z Rescue​​​​​​​
• API - Interakcja z Snapshots
• API - Interakcja z Boot From ISO