योजना एपीआई

सर्वर की योजनाएँ आप नियत करें, उनके संसाधनों और कीमतों के साथ. एक योजना का आकार बदलते समय योजना के रूप में पास करें (_u)

अंतिमबिंदुओं 2

आधार पथ /api/v1/plans

पाना /api/v1/plans/

सभी प्लान सूचीबद्ध करें

प्रत्येक सक्रिय योजना को वापस करता है, पहले सबसे अच्छा. सूची में कोई फिल्टर नहीं है तथा वर्तमान में एक पृष्ठ पर फिट होता है.

अनुमति: plans:list

उदाहरण अनुरोध

cURL

Python

JavaScript

PHP

curl -X GET "https://admin.vps.org/api/v1/plans/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

import requests

url = "https://admin.vps.org/api/v1/plans/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.get(url, headers=headers)
for plan in response.json()["results"]:
    print(plan["uuid"], plan["cpu"], plan["ram"], plan["ram_unit"], plan["monthly_price"])

const response = await fetch('https://admin.vps.org/api/v1/plans/', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
});

const data = await response.json();
console.log(data.results);

$ch = curl_init('https://admin.vps.org/api/v1/plans/');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer YOUR_API_TOKEN']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$plans = json_decode(curl_exec($ch), true);
curl_close($ch);

उदाहरण प्रतिक्रिया

{
  "count": 12,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "ed0ac717-c26c-4d9b-a801-b170c4979028",
      "cpu": 1,
      "ram": 512,
      "ram_unit": "MB",
      "disk_space": 10,
      "disk_space_total": 10240,
      "transfer": 500,
      "transfer_unit": "GB",
      "includes_ipv4": false,
      "price": "2.50",
      "cpu_type_name": "Shared",
      "is_active": true,
      "hourly_price": "0.004",
      "monthly_price": "2.50",
      "is_gpu": false,
      "gpu_count": 0,
      "gpu_model": ""
    },
    {
      "uuid": "14186969-fbaf-43e1-9ab2-b1f1aeb66674",
      "cpu": 1,
      "ram": 2,
      "ram_unit": "GB",
      "disk_space": 25,
      "disk_space_total": 25600,
      "transfer": 1,
      "transfer_unit": "TB",
      "includes_ipv4": true,
      "price": "5.00",
      "cpu_type_name": "Shared",
      "is_active": true,
      "hourly_price": "0.007",
      "monthly_price": "5.00",
      "is_gpu": false,
      "gpu_count": 0,
      "gpu_model": ""
    }
  ]
}

प्रतिक्रिया क्षेत्र

क्षेत्र	प्रकार	वर्णन
`uuid`	string	प्लान पहचानकर्ता. इसका प्रयोग करें योजना या नया__u-8859-1_BAR_
`cpu`	integer	वीसीपीएस की संख्या
`ram`, `ram_unit`	integer, string	स्मृति मात्रा और इसकी इकाई (MB या GB)
`disk_space`	integer	GB में डिस्क आकार
`disk_space_total`	integer	डिस्क आकार मे.बा. में
`transfer`, `transfer_unit`	integer, string	मासिक डाटा ट्रांसपर कर्ट तथा इसकी इकाई (GB या टी)
`disk_space_unit`	string	डिस्क_ स्पेस (GB) की इकाई
`includes_ipv4`	boolean	क्या plan में public IPv4 address शामिल है। जिन plans में यह नहीं है वे केवल IPv6 हैं; एक IPv4 address $2.00/month में जोड़ा जा सकता है।
`monthly_price`, `price`	string	अमेरिका में मासिक मूल्य एक दशमलव स्ट्रिंग के रूप में. कीमत एक ही मूल्य है.
`hourly_price`	string	अमेरिका में एक दशमलव स्ट्रिंग के रूप में घंटे की कीमत
`cpu_type_name`	string	सीपीयू क़िस्म. उदाहरण के लिए, रिजीम ने बिना सीपीयू क़िस्म के योजना के लिए ओमांग की योजना बनाई.
`is_active`	boolean	इस सूची में हमेशा सही है, क्योंकि निष्क्रिय योजना वापस नहीं दी जाती है
`is_gpu`, `gpu_count`, `gpu_model`	boolean, integer, string	क्या योजना में समर्पित जीयूस, कितने लोगों को, और कौन सा मॉडल शामिल है

response यह नहीं बताती कि किसी plan में IPv4 address शामिल है या नहीं। 512 MB plan केवल IPv6 है; बाकी मौजूदा plans में IPv4 शामिल है। ऐसी site के लिए plan चुनने से पहले जिसे IPv4 पर पहुंचा जाना ज़रूरी हो, pricing page से तुलना करें।

प्रतिक्रिया स्थिति कोड

200	प्लान सूची सफलतापूर्वक वापस किया गया
403	गुम है या अवैध एपीआई टोकन, या टोकन जरूरी अनुमति नहीं

पाना /api/v1/plans/{uuid}/

योजना के विवरण प्राप्त करें

ऊपर दिए क्षेत्रों के साथ एक सक्रिय योजना लौटाता है. एक निष्क्रिय या अज्ञात uduPPRERSE 404 का परिणाम होगा.

curl -X GET "https://admin.vps.org/api/v1/plans/ed0ac717-c26c-4d9b-a801-b170c4979028/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "uuid": "ed0ac717-c26c-4d9b-a801-b170c4979028",
  "cpu": 1,
  "ram": 512,
  "ram_unit": "MB",
  "disk_space": 10,
  "disk_space_total": 10240,
  "transfer": 500,
  "transfer_unit": "GB",
  "includes_ipv4": false,
  "price": "2.50",
  "cpu_type_name": "Shared",
  "is_active": true,
  "hourly_price": "0.004",
  "monthly_price": "2.50",
  "is_gpu": false,
  "gpu_count": 0,
  "gpu_model": ""
}