Image izveide
Lai izveidotu image, izpildiet šādu pieprasījumu:
URL:
https://api.zomro.com/Metode: POST
Pieprasījuma ķermenis (Form-data):
| Parametrs | Vērtības piemērs | Obligāts parametrs | Vērtības apraksts |
| func | v2.image.order.param | Jā | Funkcija, lai izveidotu rezerves kopijas izveides grafiku |
| auth | 21fc199...c43f71 | Nē | Sesijas tokens. Tas ir viens no autorizācijas veidiem. Plašāka informācija par citiem veidiem ir aprakstīta šeit |
| out | json | Jā | Atbildes tips, kuru sagaidīt |
| sok | ok | Jā | Operācijas apstiprinājums |
| image_type | image | Jā | Izveidotā elementa tips. Pieejamā vērtība - image |
| skipbasket | on | Jā | Ieteicams norādīt «on», jo gadījumā «off», image netiks izveidots |
| image_name | MyImage | Jā | Attēla nosaukums |
| region | Netherlands-2 | Jā | Datu centrs, kurā saglabāt image |
| min_disk | 1 | Jā | Minimālais diska izmērs GB, kas jābūt instance, lai varētu izmantot image |
| min_ram | 1 | Jā | Minimālais RAM izmērs GB, kas jābūt instance, lai varētu izmantot image |
| disk_format | iso | Jā | Attēla tips, kuru izveidot. Pieejamie parametri: "iso", "ami", "ari", "aki", "vhd", "vmdk", "raw", "qcow2", "vdi". |
| os_distro | ubuntu | Jā | OS nosaukums, kura attēls tiek izveidots |
| os_version | 22 | Nē | OS versija |
| architecture | x86_64 | Jā | OS arhitektūra. Pieejamie parametri: "x86_64", "i686", "ia64" |
| url | https://releases.ubuntu.com/24.04/ubuntu-24.04-live-server-amd64.iso | Jā | Tieša saite uz attēlu |
| protected | on | Jā | Vai atļaut dzēst attēlu. Pieejamie parametri: "on", "off" |
| pricelist | 6854 | Jā | Pakalpojuma ID, kas atbilst image pakalpojumam |
| order_period | -50 | Jā | Pasūtījuma periods. Image pakalpojuma tipam tiek izmantota tikai dienas maksa |
Image izveides piemērs
Piemēram, izveidosim Image no Ubuntu 24.04 https://releases.ubuntu.com/24.04/ubuntu-24.04-live-server-amd64.iso:
URL:
https://api.zomro.com/
Metode: POST
Pieprasījuma ķermenis (Form-data):
| Parametrs | Vērtība |
| 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 |
Lūk, piemērs pieprasījumam, kuru var izpildīt no konsoles:
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"'
Pēc pieprasījuma izpildes redzam, ka sākās image izveide. Pašreizējais statuss «Saving»:
Pēc image izveides statuss mainīsies no «Saving» uz «Active»:
Kā ar API palīdzību var iegūt visu image sarakstu
Lai to izdarītu, izpildiet šādu pieprasījuma formātu:
URL:
https://api.zomro.com/Metode: POST
Pieprasījuma ķermenis (Form-data):
| Parametrs | Vērtības piemērs | Obligāts parametrs | Vērtības apraksts |
| func | image | Jā | Funkcija, lai iegūtu visus attēlus |
| auth | 21fc199...c43f71 | Nē | Sesijas tokens. Tas ir viens no autorizācijas veidiem. Plašāka informācija par citiem veidiem ir aprakstīta šeit |
| out | json | Jā | Atbildes tips, kuru sagaidīt |
Pamēģināsim izpildīt šādu pieprasījumu konsolē:
curl --location 'https://api.zomro.com/' \
--form 'func="image"' \
--form 'auth="1176dc887b147a3eb1da748e"' \
--form 'out="json"'Saņemam šādu rezultātu:
{
"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"
}
},
],
}
}
Mūs interesē dati, kas iegūti šādā ligzdojumā:
doc.elem.[]
Lai rediģētu image, izpildiet šādu pieprasījumu:
URL:
https://api.zomro.com/Metode: POST
Pieprasījuma ķermenis (Form-data):
| Parametrs | Vērtības piemērs | Obligāts parametrs | Vērtības apraksts |
| func | image.edit | Jā | Funkcija, lai rediģētu attēlu |
| auth | 21fc199...c43f71 | Nē | Sesijas tokens. Tas ir viens no autorizācijas veidiem. Plašāka informācija par citiem veidiem ir aprakstīta šeit |
| out | json | Jā | Atbildes tips, kuru sagaidīt |
| elid | 5206258 | Jā | ID image. Šo vērtību var iegūt, atbildot uz pieprasījumu, lai iegūtu visus image |
| image_name | Ubuntu24_new | Nē | Image nosaukums |
| min_disk | 2 | Nē | Minimālais instance diska izmērs, kas nepieciešams šī attēla izmantošanai |
| min_ram | 3 | Nē | Minimālais instance atmiņas izmērs, kas nepieciešams šī attēla izmantošanai |
| os_distro | altlinux | Nē | OS nosaukums |
| os_version | 8 | Nē | OS versija |
| architecture | x86_64 | Nē | Image arhitektūra |
| protected | off | Nē | Vai atļauts dzēst image |
Pamēģināsim izpildīt šādu pieprasījumu konsolē:
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"'Pēc pieprasījuma izpildes var pārliecināties, ka image dati ir mainīti:
Image dzēšana
Lai dzēstu Image, izpildiet šādu pieprasījumu:
Metode: POST
Pieprasījuma ķermenis (Form-data):
| Parametrs | Vērtības piemērs | Obligāts parametrs | Vērtības apraksts |
| func | image.delete | Jā | Funkcija, lai dzēstu attēlu |
| auth | 21fc199...c43f71 | Nē | Sesijas tokens. Tas ir viens no autorizācijas veidiem. Plašāka informācija par citiem veidiem ir aprakstīta šeit |
| out | json | Jā | Atbildes tips, kuru sagaidīt |
| elid | 5206258 | Jā | ID image. Šo vērtību var iegūt, atbildot uz pieprasījumu, lai iegūtu visus image |
Pamēģināsim izpildīt šādu pieprasījumu konsolē:
curl --location 'https://api.zomro.com/' \
--form 'func="image.delete"' \
--form 'auth="9f467da30d0bd6c56fed1b58"' \
--form 'out="json"' \
--form 'elid="5206258"'Jāpievērš uzmanība tam, ka, lai dzēstu image, statusam «protected» jābūt «off».
Pēc pieprasījuma izpildes redzam veiksmīgu image dzēšanu.
Piedāvājam arī izpētīt rakstus, kas var būt noderīgi, lai mijiedarbotos ar Cloud VPS produktiem, izmantojot API:
- API - Pakalpojuma izveide
- API - Informācijas iegūšana par pieejamajiem tarifiem un to parametriem
- API - Operācija Start & Stop
- API - Operācija Reboot
- API - Operācija Rebuild
- API - Operācija Delete
- API - Mijiedarbība ar Backup Schedule
- API - Mijiedarbība ar Rescue
- API - Mijiedarbība ar Backup
- API - Mijiedarbība ar Snapshots
- API - Mijiedarbība ar Boot From ISO