API - Қолжетімді тарифтер мен олардың параметрлері туралы ақпарат алу

Cloud VPS қызметтерімен API арқылы жұмыс істеу үшін Zomro қол жетімді тарифтер туралы ақпарат алу үшін ыңғайлы интерфейс ұсынады. v2.instances.order.pricelist функциясының көмегімен сіз тарифтердің толық тізімін қысқаша сипаттамаларымен және бағаларымен ала аласыз. Содан кейін, v2.instances.order.param функциясын тариф ID және тапсырыс мерзімін көрсете отырып, таңдалған тарифтің толық сипаттамаларын алуға болады. Төменде әр функция үшін сұраулардың мысалдары және жауап құрылымы келтірілген. Бұл ақпарат сізге Zomro API арқылы бұлтты серверлеріңізді тиімді басқаруға көмектеседі.

Cloud VPS қызметі үшін барлық қол жетімді тарифтерді алу үшін келесі функцияны пайдалануға болады:

v2.instances.order.pricelist

Сұрау құрылымы:
URL:

https://api.zomro.com/

Сұрау әдісі: POST
Сұрау денесі (form-data):

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

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

curl --location 'https://api.zomro.com/' \
--form 'func="v2.instances.order.pricelist"' \
--form 'auth="19c8130ac494a5e7c162d246"' \
--form 'out="json"'

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

doc.list.elem

Міне, алынған элементтердің бірінің мысалы:

...,
{
"buttons": {
    "button": {
        "$name": "order",
        "$type": "func",
        "$key": "pricelist",
        "$theme": "primary",
        "$func": "v2.instances.order.param"
    }
},
"description": {},
"detail": [
    {
        "name": {
            "$": "network"
        },
        "value": {
            "$": "IPv4 NL-2"
        }
    },
    {
        "name": {
            "$": "CPU count"
        },
        "value": {
            "$": "1"
        }
    },
    {
        "name": {
            "$": "Memory"
        },
        "value": {
            "$": "2 Gb"
        }
    },
    {
        "name": {
            "$": "Disk space"
        },
        "value": {
            "$": "12 Gb"
        }
    },
    {
        "name": {
            "$": "Port speed"
        },
        "value": {
            "$": "1 Gbit/s."
        }
    },
    {
        "name": {
            "$": "Bandwidth"
        },
        "value": {
            "$": "Unmetered traffic"
        }
    }
],
"flabel": {
    "tag": [
        {
            "$": "72866a3690e44679070d48b8ffa2c963"
        },
        {
            "$": "a362f6fd19c99d07441692bf4cce537c"
        }
    ]
},
"id": {
    "$": "6740"
},
"pricelist": {
    "$": "6740"
},
"prices": {
    "$key": "period_6740",
    "price": {
        "$special_price": "no",
        "cost": {
            "$": "0.13"
        },
        "currency": {
            "$": "EUR"
        },
        "period": {
            "$": "-50"
        }
    }
},
"title": {
    "$": "Cloud Essential"
}
},
...

Осы деректерді пайдалана отырып, тарифтің ID-ін білуге болады. Біздің жағдайда мәні "6740", және тариф туралы қысқаша мәліметтер. Тариф туралы толық мәліметтер алу үшін келесі функцияны пайдалану қажет:

v2.instances.order.param

және тариф ID мен тапсырыс мерзімін көрсету қажет.

Сұрау құрылымы:

URL:

https://api.zomro.com/

Сұрау әдісі: POST
Сұрау денесі (form-data):

Параметр	Мәннің мысалы	Мәннің сипаттамасы
func	v2.instances.order.param	Тариф туралы қосымша мәліметтер алу функциясы
auth	21fc199...c43f71	Сессия токені. Бұл авторизацияның бір нұсқасы. Басқа нұсқалар туралы толығырақ мұнда сипатталған
out	json	Күтілетін жауап құрылымы
order_period	-50	Қызметті тапсырыс беруге болатын мерзім
pricelist	6740	Тапсырыс берілетін қызметтің ID-і

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

curl --location 'https://api.zomro.com/' \
--form 'func="v2.instances.order.param"' \
--form 'auth="579ea10f7790f5e7de91357c"' \
--form 'out="json"' \
--form 'order_period="-50"' \
--form 'pricelist="6740"'

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

doc.slist

Міне, сұрауды орындау нәтижесінде алынған мәндер:

{
"$name": "instances_os",
"val": [
    {
        "$key": "18d0ee2e-4d57-4f40-9b56-03c1773b5831",
        "$": "AlmaLinux 8"
    },
    {
        "$key": "5da4ad83-45f6-4c0e-9a7e-7a7c18b2be6c",
        "$": "AlmaLinux 9"
    },
    {
        "$key": "3d9d9db6-325a-4d91-9bdb-6c48ad291cb6",
        "$": "CentOS Stream 8"
    },
    {
        "$key": "7d7911e3-7178-4f36-a308-d841db5fe654",
        "$": "CentOS Stream 9"
    },
    {
        "$key": "0bf4deb2-855c-4863-8518-6006d804adbb",
        "$": "Debian 10"
    },
    {
        "$key": "3010ae60-0185-4021-98da-f50013147ebd",
        "$": "Debian 11"
    },
    {
        "$key": "93878ba5-6b9e-4924-a4be-34edb623f808",
        "$": "Debian 12"
    },
    {
        "$key": "1d9dda4c-34b0-4304-a90a-8f3018722fa2",
        "$": "Rocky-Linux-8"
    },
    {
        "$key": "a8b7bcb3-6698-4264-b413-f2b866a46a70",
        "$": "Rocky-Linux-9"
    },
    {
        "$key": "479c96f1-ccc6-47a2-952c-c9e3bbdc8d07",
        "$": "Ubuntu 20.04"
    },
    {
        "$key": "f8f2573f-56c4-44c5-8469-84eee4aa64e7",
        "$": "Ubuntu 22.04"
    },
    {
        "$key": "92fabac2-69cc-46ad-8439-c377e0c90632",
        "$": "Ubuntu 23.04"
    },
    {
        "$key": "6f8476f9-93f0-4ddd-b0fd-624e930ffacd",
        "$": "Ubuntu 23.10"
    }
]
},
{
"$name": "addon_6746",
"val": [
    {
        "$key": "259",
        "$": "IPv4 NL-2 (0.04 EUR)"
    },
    {
        "$key": "260",
        "$": "IPv6 NL-2 (0.00 EUR)"
    }
]
},
{
"$name": "addon_6745",
"val": [
    {
        "$key": "58",
        "$": "1 (0.00 EUR)"
    }
]
},
{
"$name": "addon_6744",
"val": [
    {
        "$key": "42",
        "$": "2 Gb (0.00 EUR)"
    }
]
},
{
"$name": "addon_6743",
"val": [
    {
        "$key": "143",
        "$": "12 Gb (0.00 EUR)"
    }
]
},
{
"$name": "addon_6742",
"val": [
    {
        "$key": "246",
        "$": "1 Gbit/s. (0.00 EUR)"
    }
]
},
{
"$name": "addon_6741",
"val": [
    {
        "$key": "244",
        "$": "Unmetered traffic (0.00 EUR)"
    }
]
},
{
"$name": "order_period",
"val": [
    {
        "$msg": "yes",
        "$key": "-50",
        "$": "Day"
    }
]
},
{
"$name": "instances_ssh_keys",
"val": [
    {
        "$key": "283",
        "$": "new"
    },
    {
        "$key": "471",
        "$": "111"
    },
    {
        "$key": "490",
        "$": "1115"
    }
]
}

Бұл жазба келесі деректерді ұсынады:

Параметр атауы	Параметр сипаттамасы
instances_os	Осы тариф үшін орнатуға қол жетімді ОС
addon_6746	Қандай IP түрін пайдалану керек. Егер тек IPv6 таңдалса, серверге IPv4 берілмейді. IPv4 жағдайында серверге IPv6 және IPv4 беріледі. Бұл жағдайда қызметтің құны артады.
addon_6745	Тапсырыс беруге қол жетімді CPU саны
addon_6744	Тапсырыс беруге қол жетімді RAM саны
addon_6743	Сервердегі дискілік кеңістік мөлшері
addon_6742	Сервердегі интернет-трафиктің өткізу жылдамдығы
addon_6741	Сервердегі интернет-трафиктің шектеуі
order_period	Қызметті төлеу мерзімдері
instances_ssh_keys	Жеке кабинетте қосылған SSH кілттері

Осы параметрлерді пайдалана отырып, қызметті тапсырыс беруге болады.

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