Àwọn Ètò API

List the server plans you can deploy, with their resources and prices. Pass a plan's uuid as plan_uuid when you create or resize a server.

Àwọn ìparí 2

Ipa-ọna Ipilẹ /api/v1/plans

GBÀ /api/v1/plans/

Ṣe àkójọ gbogbo Ètò

Fi àwọn àwọn ìṣàmúlò-ètò gbogbo lọ́wọ́lọ́wọ́ pamọ́, àwọn tí o pọ̀jú ní akọkọ. Àtòjọ náà kò ní àwọn ìṣàmúlò-ètò náà, àti ní ìṣàmúlò-ètò náà ní pàtó ní ojú-ìwé kan.

Àwọn ìkúndùǹ tí a fẹ́: plans:list

Àpẹẹrẹ Ìbéèrè

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

Àpẹẹrẹ Ìdáhùn

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

Àwọn Ààyè Ìdáhùn

Àwọn Ààyè-iṣẹ́	Irú	Àwọn Àkọlé
`uuid`	string	Àtòjọ-ẹ̀yàn àtòjọ-ètò. Lò ní bíi àtòjọ-ètò_uuid tàbí àtòjọ-ètò_uuid tuntun.
`cpu`	integer	Àwọn Ìdídúrò
`ram`, `ram_unit`	integer, string	Ìbàmúlò-ètò ìrànwọ́ àti àwọn ìrísí-lẹ́tà rẹ (MB tàbí GB)
`disk_space`	integer	Ìwọ̀n dískì nínú GB
`disk_space_total`	integer	Ìwọ̀n dískì nínú MB
`transfer`, `transfer_unit`	integer, string	Àwọn ìṣàmúlò-ètò ìṣàmúlò-ètò data oṣù kan àti àwọn ìṣàmúlò-ètò rẹ (GB tàbí TB)
`disk_space_unit`	string	Àwọn ààyè-iṣẹ́ àwọn disiki
`includes_ipv4`	boolean	Tó bá jẹ́ pé àtòjọ-ẹ̀yàn náà ní àdírẹ̀sì IPv4 aládàpò. Àtòjọ-ẹ̀yàn tí kò bá jẹ́ ọkan ní IPv6 nikan; àtòjọ-ẹ̀yàn IPv4 lè á fàyè gba $2.00/òṣù.
`monthly_price`, `price`	string	Àwọn àwọn ìṣàmúlò-ètò nínú USD bí àwọn àyọkà ìsàlẹ̀-ètò. àwọn àwọn ìṣàmúlò-ètò nínú àwọn
`hourly_price`	string	Àwọn àwọn ìṣàmúlò-ètò àwọn
`cpu_type_name`	string	Irúfẹ́ CPU, àwọn ààyè-iṣẹ́ bíi Àwọn Ìṣàmúlò-ètò Ìpàpọ̀. A tí kò fi àwọn àwọn ìṣàmúlò-ètò tí kò ní irúfẹ́ CPU, bíi àwọn ìṣàmúlò-ètò GPU.
`is_active`	boolean	Always true in this list, because inactive plans are not returned
`is_gpu`, `gpu_count`, `gpu_model`	boolean, integer, string	Bó àtòjọ-ẹ̀yàn náà ń fá GPUs àìdájú, àwọn ìṣàmúlò-ètò wò nípa àwọn ìṣàmúlò-ètò wò

The response does not say whether a plan includes an IPv4 address. The 512 MB plan is IPv6 only; the other current plans include IPv4. Compare with the pricing page before choosing a plan for a site that must be reachable over IPv4.

Àwọn Kóòdù Ipò Ìdáhùn

200	Àtòjọ àwọn ìṣàmúlò-ètò tí a tí ìjádè
403	Tokénà API tí kò bá jẹ́ tàbí tí kò bá jẹ́, tàbí tokénà náà kò ní ìṣẹ̀dà tí a fẹ́

GBÀ /api/v1/plans/{uuid}/

Gba Àwọn Àlàyé Ètò náà

Fi àwọn ààtò ìṣàmúlò-ètò tí a lò nínú àwọn ààyè-iṣẹ́ tí a fi ààyè-iṣẹ́ pamọ́. UID tí kò bá jẹ́ àtòjọ-ẹ̀yàn tabi tí a kò mọ̀ láti fi 404 pamọ́.

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": ""
}