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

Image жасау

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

URL:

https://api.zomro.com/

Әдіс: POST

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

Параметр	Мәннің мысалы	Міндетті параметр	Мәннің сипаттамасы
func	v2.image.order.param	Иә	Резервтік көшірме жасау кестесін жасау функциясы
auth	21fc199...c43f71	Жоқ	Сессия токені. Бұл авторизацияның бір нұсқасы. Қосымша нұсқалар туралы толығырақ мұнда сипатталған
out	json	Иә	Күтілетін жауап түрі
sok	ok	Иә	Операцияны растау
image_type	image	Иә	Жасалған элемент түрі. Қол жетімді мән - image
skipbasket	on	Иә	"off" болған жағдайда image жасалмайды, сондықтан "on" көрсету ұсынылады
image_name	MyImage	Иә	Сурет атауы
region	Netherlands-2	Иә	Image сақталатын деректер орталығы
min_disk	1	Иә	Image пайдалану үшін instance-де болуы керек дискінің минималды өлшемі (ГБ)
min_ram	1	Иә	Image пайдалану үшін instance-де болуы керек ОЗУ минималды өлшемі (ГБ)
disk_format	iso	Иә	Жасалатын сурет түрі. Қол жетімді параметрлер: "iso", "ami", "ari", "aki", "vhd", "vmdk", "raw", "qcow2", "vdi".
os_distro	ubuntu	Иә	Жасалатын ОС образының атауы
os_version	22	Жоқ	ОС нұсқасы
architecture	x86_64	Иә	ОС архитектурасы. Қол жетімді параметрлер: "x86_64", "i686", "ia64"
url	https://releases.ubuntu.com/24.04/ubuntu-24.04-live-server-amd64.iso	Иә	Суретке тікелей сілтеме
protected	on	Иә	Суретті жоюға рұқсат беру. Қол жетімді параметрлер: "on", "off"
pricelist	6854	Иә	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):

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

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

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

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

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

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

Параметр	Мәннің мысалы	Міндетті параметр	Мәннің сипаттамасы
func	image.edit	Иә	Суретті өңдеу функциясы
auth	21fc199...c43f71	Жоқ	Сессия токені. Бұл авторизацияның бір нұсқасы. Қосымша нұсқалар туралы толығырақ мұнда сипатталған
out	json	Иә	Күтілетін жауап түрі
elid	5206258	Иә	Image ID. Бұл мәнді барлық image алу сұранысына жауап ретінде алуға болады
image_name	Ubuntu24_new	Жоқ	Image атауы
min_disk	2	Жоқ	Бұл образды пайдалану үшін instance-де қажет дискінің минималды өлшемі
min_ram	3	Жоқ	Бұл образды пайдалану үшін instance-де қажет жедел жадтың минималды өлшемі
os_distro	altlinux	Жоқ	ОС атауы
os_version	8	Жоқ	ОС нұсқасы
architecture	x86_64	Жоқ	Image архитектурасы
protected	off	Жоқ	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):

Параметр	Мәннің мысалы	Міндетті параметр	Мәннің сипаттамасы
func	image.delete	Иә	Суретті жою функциясы
auth	21fc199...c43f71	Жоқ	Сессия токені. Бұл авторизацияның бір нұсқасы. Қосымша нұсқалар туралы толығырақ мұнда сипатталған
out	json	Иә	Күтілетін жауап түрі
elid	5206258	Иә	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 өнімдерімен өзара әрекеттесу үшін пайдалы болуы мүмкін мақалаларды оқуды ұсынамыз: