opened image

API - ტარიფების და მათი პარამეტრების შესახებ ინფორმაციის მიღება

Cloud VPS სერვისებთან მუშაობისთვის API-ის მეშვეობით Zomro გთავაზობთ მოსახერხებელ ინტერფეისს ხელმისაწვდომი ტარიფების შესახებ ინფორმაციის მისაღებად. ფუნქციის v2.instances.order.pricelist გამოყენებით შეგიძლიათ მიიღოთ ტარიფების სრული სია მოკლე აღწერით და ფასებით. შემდეგ, ფუნქციის v2.instances.order.param გამოყენებით, ტარიფის ID-ისა და შეკვეთის პერიოდის მითითებით, შეგიძლიათ მიიღოთ არჩეული ტარიფის დეტალური მახასიათებლები. ქვემოთ მოცემულია მოთხოვნების მაგალითები და თითოეული ფუნქციის პასუხის სტრუქტურა. ეს ინფორმაცია დაგეხმარებათ ეფექტურად მართოთ თქვენი ღრუბლოვანი სერვერები API Zomro-ს მეშვეობით.

ყველა ხელმისაწვდომი ტარიფის მისაღებად Cloud VPS სერვისისთვის, შეგიძლიათ გამოიყენოთ შემდეგი ფუნქცია:

v2.instances.order.pricelist

 

მოთხოვნის სტრუქტურა:
URL: 

https://api.zomro.com/

მოთხოვნის მეთოდი: POST
მოთხოვნის სხეული (form-data):

 

პარამეტრიმნიშვნელობის მაგალითიმნიშვნელობის აღწერა
funcv2.instances.order.pricelistფუნქცია ხელმისაწვდომი ტარიფების მისაღებად
auth21fc199...c43f71სესიის ტოკენი. ეს არის ავტორიზაციის ერთ-ერთი ვარიანტი. სხვა ვარიანტების შესახებ დაწვრილებით აღწერილია აქ
outjsonპასუხის სტრუქტურა, რომელსაც ველოდებით

 

აი, მოთხოვნის მაგალითი, რომელიც შეგიძლიათ შეასრულოთ კონსოლიდან:

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

პარამეტრიმნიშვნელობის მაგალითიმნიშვნელობის აღწერა
funcv2.instances.order.paramფუნქცია ტარიფის დამატებითი მონაცემების მისაღებად
auth21fc199...c43f71სესიის ტოკენი. ეს არის ავტორიზაციის ერთ-ერთი ვარიანტი. სხვა ვარიანტების შესახებ დაწვრილებით აღწერილია აქ
outjsonპასუხის სტრუქტურა, რომელსაც ველოდებით
order_period-50პერიოდი, რომელზეც შეგიძლიათ შეუკვეთოთ სერვისი
pricelist6740სერვისის 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_6746IP ტიპი, რომელიც უნდა გამოიყენოთ. თუ აირჩევთ მხოლოდ IPv6-ს, IPv4 არ გაიცემა სერვერისთვის. IPv4-ის შემთხვევაში გაიცემა როგორც IPv6, ასევე IPv4. ამ შემთხვევაში სერვისის ღირებულება გაიზრდება.
addon_6745CPU-ების რაოდენობა, რომლებიც ხელმისაწვდომია შეკვეთისთვის
addon_6744RAM-ის რაოდენობა, რომელიც ხელმისაწვდომია შეკვეთისთვის
addon_6743დისკური სივრცის ზომა სერვერზე
addon_6742ინტერნეტ ტრაფიკის სიჩქარე სერვერზე
addon_6741ინტერნეტ ტრაფიკის რაოდენობის შეზღუდვა სერვერზე
order_periodსერვისის გადახდის ხელმისაწვდომი პერიოდები
instances_ssh_keysSSH გასაღებები, რომლებიც დამატებულია პირად კაბინეტში

ამ პარამეტრების გამოყენებით, შეგიძლიათ შეუკვეთოთ სერვისი. 

ასევე გთავაზობთ შეისწავლოთ სტატიები, რომლებიც შეიძლება სასარგებლო იყოს Cloud VPS პროდუქტებთან API-ის მეშვეობით მუშაობისთვის: