opened image

API - Mijiedarbība ar Image

Image izveide

Lai izveidotu image, izpildiet šādu pieprasījumu:

 

URL: 

https://api.zomro.com/

Metode: POST

Pieprasījuma ķermenis (Form-data):

ParametrsVērtības piemērsObligāts parametrsVērtības apraksts
funcv2.image.order.paramJāFunkcija, lai izveidotu rezerves kopijas izveides grafiku
auth21fc199...c43f71NēSesijas tokens. Tas ir viens no autorizācijas veidiem. Plašāka informācija par citiem veidiem ir aprakstīta šeit
outjsonJāAtbildes tips, kuru sagaidīt
sokokJāOperācijas apstiprinājums
image_typeimageJāIzveidotā elementa tips. Pieejamā vērtība - image
skipbasketonJāIeteicams norādīt «on», jo gadījumā «off», image netiks izveidots  
image_nameMyImageJāAttēla nosaukums
regionNetherlands-2JāDatu centrs, kurā saglabāt image
min_disk1JāMinimālais diska izmērs GB, kas jābūt instance, lai varētu izmantot image
min_ram1JāMinimālais RAM izmērs GB, kas jābūt instance, lai varētu izmantot image
disk_formatisoJāAttēla tips, kuru izveidot. Pieejamie parametri: "iso", "ami", "ari", "aki", "vhd", "vmdk", "raw", "qcow2", "vdi". 
os_distroubuntuJāOS nosaukums, kura attēls tiek izveidots
os_version22NēOS versija
architecturex86_64JāOS arhitektūra. Pieejamie parametri: "x86_64", "i686", "ia64"
urlhttps://releases.ubuntu.com/24.04/ubuntu-24.04-live-server-amd64.isoJāTieša saite uz attēlu
protectedonJāVai atļaut dzēst attēlu. Pieejamie parametri: "on", "off"
pricelist6854JāPakalpojuma ID, kas atbilst image pakalpojumam
order_period-50Jā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):

ParametrsVērtība
funcv2.image.order.param
auth21fc199...c43f71
outjson
sokok
image_typeimage
skipbasketon
image_nameUbuntu24
regionNetherlands-2
min_disk1
min_ram1
disk_formatiso
os_distroubuntu
os_version24
architecturex86_64
urlhttps://releases.ubuntu.com/24.04/ubuntu-24.04-live-server-amd64.iso
protectedon
pricelist6854
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»:

API - Mijiedarbība ar Image - 1

 

Pēc image izveides statuss mainīsies no «Saving» uz «Active»:

API - Mijiedarbība ar Image - 2

 

 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):

ParametrsVērtības piemērsObligāts parametrsVērtības apraksts
funcimageJāFunkcija, lai iegūtu visus attēlus
auth21fc199...c43f71NēSesijas tokens. Tas ir viens no autorizācijas veidiem. Plašāka informācija par citiem veidiem ir aprakstīta šeit
outjsonJā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):

ParametrsVērtības piemērsObligāts parametrsVērtības apraksts
funcimage.editJāFunkcija, lai rediģētu attēlu
auth21fc199...c43f71NēSesijas tokens. Tas ir viens no autorizācijas veidiem. Plašāka informācija par citiem veidiem ir aprakstīta šeit
outjsonJāAtbildes tips, kuru sagaidīt
elid5206258JāID image. Šo vērtību var iegūt, atbildot uz pieprasījumu, lai iegūtu visus image
image_nameUbuntu24_newNēImage nosaukums
min_disk2NēMinimālais instance diska izmērs, kas nepieciešams šī attēla izmantošanai
min_ram3NēMinimālais instance atmiņas izmērs, kas nepieciešams šī attēla izmantošanai
os_distroaltlinuxNēOS nosaukums
os_version8NēOS versija
architecturex86_64NēImage arhitektūra
protectedoffNē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:

API - Mijiedarbība ar Image - 3

 

Image dzēšana

 

Lai dzēstu Image, izpildiet šādu pieprasījumu:

 

Metode: POST

Pieprasījuma ķermenis (Form-data):

ParametrsVērtības piemērsObligāts parametrsVērtības apraksts
funcimage.deleteJāFunkcija, lai dzēstu attēlu
auth21fc199...c43f71NēSesijas tokens. Tas ir viens no autorizācijas veidiem. Plašāka informācija par citiem veidiem ir aprakstīta šeit
outjsonJāAtbildes tips, kuru sagaidīt
elid5206258Jā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.

API - Mijiedarbība ar Image - 4

 

Piedāvājam arī izpētīt rakstus, kas var būt noderīgi, lai mijiedarbotos ar Cloud VPS produktiem, izmantojot API: