Image kūrimas
Norėdami sukurti image, atlikite šią užklausą:
URL:
https://api.zomro.com/Metodas: POST
Užklausos kūnas (Form-data):
| Parametras | Reikšmės pavyzdys | Privalomas parametras | Reikšmės aprašymas |
| func | v2.image.order.param | Taip | Funkcija, skirta sukurti atsarginės kopijos kūrimo tvarkaraštį |
| auth | 21fc199...c43f71 | Ne | Sesijos žetonas. Tai vienas iš autorizacijos variantų. Daugiau apie kitus variantus aprašyta čia |
| out | json | Taip | Atsakymo tipas, kurio tikėtis |
| sok | ok | Taip | Operacijos patvirtinimas |
| image_type | image | Taip | Sukurto elemento tipas. Galima reikšmė - image |
| skipbasket | on | Taip | Rekomenduojama nurodyti „on“, nes jei bus „off“, image nebus sukurtas |
| image_name | MyImage | Taip | Vaizdo pavadinimas |
| region | Netherlands-2 | Taip | Duomenų centras, kuriame išsaugoti image |
| min_disk | 1 | Taip | Minimalus disko dydis GB, kuris turi būti instance, kad būtų galima naudoti image |
| min_ram | 1 | Taip | Minimalus RAM dydis GB, kuris turi būti instance, kad būtų galima naudoti image |
| disk_format | iso | Taip | Vaizdo tipas, kurį sukurti. Galimi parametrai: „iso“, „ami“, „ari“, „aki“, „vhd“, „vmdk“, „raw“, „qcow2“, „vdi“. |
| os_distro | ubuntu | Taip | OS pavadinimas, kurio vaizdas kuriamas |
| os_version | 22 | Ne | OS versija |
| architecture | x86_64 | Taip | OS architektūra. Galimi parametrai: „x86_64“, „i686“, „ia64“ |
| url | https://releases.ubuntu.com/24.04/ubuntu-24.04-live-server-amd64.iso | Taip | Tiesioginė nuoroda į vaizdą |
| protected | on | Taip | Ar leisti ištrinti vaizdą. Galimi parametrai: „on“, „off“ |
| pricelist | 6854 | Taip | Paslaugos ID, atitinkantis image paslaugą |
| order_period | -50 | Taip | Užsakymo laikotarpis. Image paslaugos tipui naudojamas tik dienos mokestis |
Image kūrimo pavyzdys
Pavyzdžiui, sukursime Image iš Ubuntu 24.04 https://releases.ubuntu.com/24.04/ubuntu-24.04-live-server-amd64.iso:
URL:
https://api.zomro.com/
Metodas: POST
Užklausos kūnas (Form-data):
| Parametras | Reikšmė |
| func | v2.image.order.param |
| auth | 21fc199...c43f71 |
| out | json |
| sok | ok |
| image_type | image |
| skipbasket | on |
| image_name | Ubuntu24 |
| region | Netherlands-2 |
| min_disk | 1 |
| min_ram | 1 |
| disk_format | iso |
| os_distro | ubuntu |
| os_version | 24 |
| architecture | x86_64 |
| url | https://releases.ubuntu.com/24.04/ubuntu-24.04-live-server-amd64.iso |
| protected | on |
| pricelist | 6854 |
| order_period | -50 |
Štai užklausos pavyzdys, kurį galima atlikti iš konsolės:
curl --location 'https://api.zomro.com/' \
--form 'func="v2.image.order.param"' \
--form 'auth="0f6744198ec41bb23fe1c923"' \
--form 'out="json"' \
--form 'sok="ok"' \
--form 'image_type="image"' \
--form 'skipbasket="on"' \
--form 'image_name="Ubuntu24"' \
--form 'region="Netherlands-2"' \
--form 'min_disk="1"' \
--form 'min_ram="1"' \
--form 'disk_format="iso"' \
--form 'os_distro="ubuntu"' \
--form 'os_version="22"' \
--form 'architecture="x86_64"' \
--form 'url="https://releases.ubuntu.com/24.04/ubuntu-24.04-live-server-amd64.iso"' \
--form 'protected="on"' \
--form 'pricelist="6854"' \
--form 'order_period="-50"'
Po užklausos atlikimo matome, kad pradėtas kurti image. Dabartinis statusas „Saving“:
Po image sukūrimo, statusas pasikeis iš „Saving“ į „Active“:
Kaip su API pagalba gauti visų image sąrašą
Tam atlikite šią užklausą:
URL:
https://api.zomro.com/Metodas: POST
Užklausos kūnas (Form-data):
| Parametras | Reikšmės pavyzdys | Privalomas parametras | Reikšmės aprašymas |
| func | image | Taip | Funkcija, skirta gauti visus vaizdus |
| auth | 21fc199...c43f71 | Ne | Sesijos žetonas. Tai vienas iš autorizacijos variantų. Daugiau apie kitus variantus aprašyta čia |
| out | json | Taip | Atsakymo tipas, kurio tikėtis |
Pabandykime atlikti šią užklausą konsolėje:
curl --location 'https://api.zomro.com/' \
--form 'func="image"' \
--form 'auth="1176dc887b147a3eb1da748e"' \
--form 'out="json"'Gauname šį rezultatą:
{
"doc": {
...
"elem": [
{
"abusesuspend": {
"$": "off"
},
"architecture": {
"$": "x86_64"
},
"archived": {
"$": "off"
},
"autosuspend": {
"$": "off"
},
"billdaily": {
"$": "on"
},
"billhourly": {
"$": "off"
},
"change_pl": {
"$": "0"
},
"change_pricelist": {
"$": "off"
},
"changepolicy": {
"$": "2"
},
"cost": {
"$": "0.00 EUR / Day"
},
"costperiod": {
"$": "-50"
},
"createdate": [
{
"$": "2024-07-24"
},
{
"$": "2024-07-24"
}
],
"currency_id": {
"$": "153"
},
"currency_str": {
"$": "EUR"
},
"description": {},
"disk_format": {
"$": "iso"
},
"employeesuspend": {
"$": "off"
},
"expiredate": {
"$": "Daily charges"
},
"fleio_id": {
"$": "802c0ad6-c918-4769-8111-0a165a076ca4"
},
"fleio_status": {
"$": "Active"
},
"has_ip_pricelist": {
"$": "off"
},
"hypervisor_type": {
"$": "Any hypervisor"
},
"i_expiretime": {
"$": "14:44:24"
},
"i_opentime": {
"$": "15:45:12"
},
"id": {
"$": "5206258"
},
"image_name": {
"$": "Ubuntu24"
},
"image_size": {
"$": "3"
},
"image_type": {
"$": "Image"
},
"intname": [
{
"$": "image"
},
{
"$": "image"
}
],
"it_accurate_billing": {
"$": "no"
},
"item_cost": {
"$": "0.0000"
},
"item_real_status": {
"$": "2"
},
"item_status": {
"$color": "green",
"$orig": "2",
"$": "Active"
},
"itemtype": {
"$": "27163"
},
"min_disk": {
"$": "1"
},
"min_ram": {
"$": "1"
},
"module_failed": {
"$": "off"
},
"module_upload_doc": {
"$": "off"
},
"name": {
"$": "Image #5206258"
},
"no_instruction": {
"$": "on"
},
"order_disabled": {
"$": "off"
},
"os_distro": {
"$": "Ubuntu"
},
"os_version": {
"$": "22"
},
"period": {
"$": "-50"
},
"pmmodule": {
"$": "pmimagemodule"
},
"price_on_request": {
"$": "off"
},
"pricelist": {
"$": "Image"
},
"pricelist_id": {
"$": "6854"
},
"processingmodule_failed": {
"$": "off"
},
"processingnode": {},
"protected": {
"$orig": "on",
"$": "Enable"
},
"real_expiredate": {
"$": "2024-07-25"
},
"region": {
"$": "Netherlands-2"
},
"scheduledclose": {
"$": "off"
},
"show_changepassword": {
"$": "off"
},
"show_domain_validation_button": {
"$": "off"
},
"show_hardreboot": {
"$": "off"
},
"show_movetovdc": {
"$": "off"
},
"show_reboot": {
"$": "on"
},
"show_supportpassword": {
"$": "off"
},
"show_vdc_loadbalancer": {
"$": "off"
},
"show_vdc_network": {
"$": "off"
},
"show_vdc_router": {
"$": "off"
},
"show_vdc_vm": {
"$": "off"
},
"show_vdc_volume": {
"$": "off"
},
"show_webconsole": {
"$": "off"
},
"specialstatus": {
"$": "0"
},
"stat_enabled": {
"$": "on"
},
"status": {
"$": "2"
},
"subaccount": {
"$": "351336"
},
"sync_feature": {
"$": "off"
},
"transition": {
"$": "off"
},
"visibility": {
"$": "Private"
}
},
],
}
}
Mus domina duomenys, kurie gauti šioje struktūroje:
doc.elem.[]
Norėdami redaguoti image, atlikite šią užklausą:
URL:
https://api.zomro.com/Metodas: POST
Užklausos kūnas (Form-data):
| Parametras | Reikšmės pavyzdys | Privalomas parametras | Reikšmės aprašymas |
| func | image.edit | Taip | Funkcija, skirta redaguoti vaizdą |
| auth | 21fc199...c43f71 | Ne | Sesijos žetonas. Tai vienas iš autorizacijos variantų. Daugiau apie kitus variantus aprašyta čia |
| out | json | Taip | Atsakymo tipas, kurio tikėtis |
| elid | 5206258 | Taip | Image ID. Šią reikšmę galima gauti atsakant į užklausą dėl visų image gavimo |
| image_name | Ubuntu24_new | Ne | Image pavadinimas |
| min_disk | 2 | Ne | Minimalus disko dydis instance, kuris reikalingas šiam vaizdui naudoti |
| min_ram | 3 | Ne | Minimalus atminties dydis instance, kuris reikalingas šiam vaizdui naudoti |
| os_distro | altlinux | Ne | OS pavadinimas |
| os_version | 8 | Ne | OS versija |
| architecture | x86_64 | Ne | Image architektūra |
| protected | off | Ne | Ar leidžiama ištrinti image |
Pabandykime atlikti šią užklausą konsolėje:
curl --location 'https://api.zomro.com/' \
--form 'func="image.edit"' \
--form 'auth="00bef0b977845f71a1583a2c"' \
--form 'out="json"' \
--form 'sok="ok"' \
--form 'elid="5206258"' \
--form 'image_name="Ubuntu24_new"' \
--form 'min_disk="2"' \
--form 'min_ram="3"' \
--form 'os_distro="altlinux"' \
--form 'os_version="8"' \
--form 'architecture="x86_64"' \
--form 'protected="on"'Po užklausos atlikimo galima įsitikinti, kad image duomenys pasikeitė:
Image ištrynimas
Norėdami ištrinti Image, atlikite šią užklausą:
Metodas: POST
Užklausos kūnas (Form-data):
| Parametras | Reikšmės pavyzdys | Privalomas parametras | Reikšmės aprašymas |
| func | image.delete | Taip | Funkcija, skirta ištrinti vaizdą |
| auth | 21fc199...c43f71 | Ne | Sesijos žetonas. Tai vienas iš autorizacijos variantų. Daugiau apie kitus variantus aprašyta čia |
| out | json | Taip | Atsakymo tipas, kurio tikėtis |
| elid | 5206258 | Taip | Image ID. Šią reikšmę galima gauti atsakant į užklausą dėl visų image gavimo |
Pabandykime atlikti šią užklausą konsolėje:
curl --location 'https://api.zomro.com/' \
--form 'func="image.delete"' \
--form 'auth="9f467da30d0bd6c56fed1b58"' \
--form 'out="json"' \
--form 'elid="5206258"'Taip pat verta atkreipti dėmesį, kad norint ištrinti image, statusas „protected“ turi būti „off“.
Po užklausos atlikimo matome sėkmingą image ištrynimą.
Taip pat siūlome susipažinti su straipsniais, kurie gali būti naudingi sąveikai su Cloud VPS produktais naudojant API:
- API - Paslaugos kūrimas
- API - Informacijos apie galimus tarifus ir jų parametrus gavimas
- API - Operacija Start & Stop
- API - Operacija Reboot
- API - Operacija Rebuild
- API - Operacija Delete
- API - Sąveika su Backup Schedule
- API - Sąveika su Rescue
- API - Sąveika su Backup
- API - Sąveika su Snapshots
- API - Sąveika su Boot From ISO