opened image

API - Image-пен өзара әрекеттесу

Image жасау

Image жасау үшін келесі сұранысты орындаңыз:

 

URL: 

https://api.zomro.com/

Әдіс: POST

Сұраныс денесі (Form-data):

ПараметрМәннің мысалыМіндетті параметрМәннің сипаттамасы
funcv2.image.order.paramИәРезервтік көшірме жасау кестесін жасау функциясы
auth21fc199...c43f71ЖоқСессия токені. Бұл авторизацияның бір нұсқасы. Қосымша нұсқалар туралы толығырақ мұнда сипатталған
outjsonИәКүтілетін жауап түрі
sokokИәОперацияны растау
image_typeimageИәЖасалған элемент түрі. Қол жетімді мән - image
skipbasketonИә"off" болған жағдайда image жасалмайды, сондықтан "on" көрсету ұсынылады
image_nameMyImageИәСурет атауы
regionNetherlands-2ИәImage сақталатын деректер орталығы
min_disk1ИәImage пайдалану үшін instance-де болуы керек дискінің минималды өлшемі (ГБ)
min_ram1ИәImage пайдалану үшін instance-де болуы керек ОЗУ минималды өлшемі (ГБ)
disk_formatisoИәЖасалатын сурет түрі. Қол жетімді параметрлер: "iso", "ami", "ari", "aki", "vhd", "vmdk", "raw", "qcow2", "vdi".
os_distroubuntuИәЖасалатын ОС образының атауы
os_version22ЖоқОС нұсқасы
architecturex86_64ИәОС архитектурасы. Қол жетімді параметрлер: "x86_64", "i686", "ia64"
urlhttps://releases.ubuntu.com/24.04/ubuntu-24.04-live-server-amd64.isoИәСуретке тікелей сілтеме
protectedonИәСуретті жоюға рұқсат беру. Қол жетімді параметрлер: "on", "off"
pricelist6854ИәImage қызметіне сәйкес келетін қызметтің ID
order_period-50ИәТапсырыс мерзімі. Image қызмет түрі үшін тек күнделікті төлем қолданылады

 

Image жасау мысалы

Мысал ретінде, Ubuntu 24.04-тен Image жасаймыз https://releases.ubuntu.com/24.04/ubuntu-24.04-live-server-amd64.iso:

 

URL: 

https://api.zomro.com/

 

Әдіс: POST

Сұраныс денесі (Form-data):

ПараметрМән
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

 

Міне, консольден орындауға болатын сұраныс мысалы:

 

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

 

Сұранысты орындағаннан кейін, image жасау басталғанын көреміз. Ағымдағы статус "Saving":

 

Image жасалғаннан кейін, статус "Saving"-ден "Active"-ге өзгереді:

 

 API арқылы барлық image тізімін қалай алуға болады

 

 

Ол үшін келесі сұраныс форматын орындаймыз:

 URL: 

https://api.zomro.com/

Әдіс: POST

Сұраныс денесі (Form-data):

ПараметрМәннің мысалыМіндетті параметрМәннің сипаттамасы
funcimageИәБарлық суреттерді алу функциясы
auth21fc199...c43f71ЖоқСессия токені. Бұл авторизацияның бір нұсқасы. Қосымша нұсқалар туралы толығырақ мұнда сипатталған
outjsonИәКүтілетін жауап түрі

Консольде келесі сұранысты орындап көрейік:

curl --location 'https://api.zomro.com/' \
--form 'func="image"' \
--form 'auth="1176dc887b147a3eb1da748e"' \
--form 'out="json"'

Келесі нәтижені аламыз:

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

 

Бізді келесі деңгейдегі деректер қызықтырады:​​​​​​​

doc.elem.[]

 

Image өңдеу үшін келесі сұранысты орындаймыз:

 URL: 

https://api.zomro.com/

Әдіс: POST

Сұраныс денесі (Form-data):

ПараметрМәннің мысалыМіндетті параметрМәннің сипаттамасы
funcimage.editИәСуретті өңдеу функциясы
auth21fc199...c43f71ЖоқСессия токені. Бұл авторизацияның бір нұсқасы. Қосымша нұсқалар туралы толығырақ мұнда сипатталған
outjsonИәКүтілетін жауап түрі
elid5206258ИәImage ID. Бұл мәнді барлық image алу сұранысына жауап ретінде алуға болады
image_nameUbuntu24_newЖоқImage атауы
min_disk2ЖоқБұл образды пайдалану үшін instance-де қажет дискінің минималды өлшемі
min_ram3ЖоқБұл образды пайдалану үшін instance-де қажет жедел жадтың минималды өлшемі
os_distroaltlinuxЖоқОС атауы
os_version8ЖоқОС нұсқасы
architecturex86_64ЖоқImage архитектурасы
protectedoffЖоқImage жоюға рұқсат етілген бе

Консольде келесі сұранысты орындап көрейік:

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

Сұранысты орындағаннан кейін image деректерінің өзгергеніне көз жеткізуге болады:

 

Image жою

 

Image жою үшін келесі сұранысты орындаймыз:

 

Әдіс: POST

Сұраныс денесі (Form-data):

ПараметрМәннің мысалыМіндетті параметрМәннің сипаттамасы
funcimage.deleteИәСуретті жою функциясы
auth21fc199...c43f71ЖоқСессия токені. Бұл авторизацияның бір нұсқасы. Қосымша нұсқалар туралы толығырақ мұнда сипатталған
outjsonИәКүтілетін жауап түрі
elid5206258ИәImage ID. Бұл мәнді барлық image алу сұранысына жауап ретінде алуға болады

Консольде келесі сұранысты орындап көрейік:

curl --location 'https://api.zomro.com/' \
--form 'func="image.delete"' \
--form 'auth="9f467da30d0bd6c56fed1b58"' \
--form 'out="json"' \
--form 'elid="5206258"'

Сондай-ақ, image жою үшін "protected" статусы "off" болуы керек екенін ескеріңіз.

Сұранысты орындағаннан кейін image сәтті жойылғанын көреміз.

 

Сондай-ақ, API арқылы Cloud VPS өнімдерімен өзара әрекеттесу үшін пайдалы болуы мүмкін мақалаларды оқуды ұсынамыз:

Ұқсас мақалалар
PPTP (Point-to-Point Tunneling Protocol) VPN желісінде. Бұл не?Samba сервері не үшін қажет?API - Резервтік көшірмемен өзара әрекеттесуБұлтты VPS-те қауіпсіздік: серверді шабуылдардан қалай қорғауға боладыAPI - Қолжетімді тарифтер мен олардың параметрлері туралы ақпарат алу

GPU видеокартасы бар сервер

€385/АЙ

Тапсырыс беру