Áætlunarforritaskil

Listi yfir þjónaáætlanir sem hægt er að nota, með auðlindum og verði. Senda uuid áætlunar sem plan_ uuid þegar þú býrð til eða breytir stærð þjóns.

Endapunktar 2

Grunnslóð /api/v1/plans

FÁ /api/v1/plans/

Listi yfir allar áætlanir

Sýnir allar virkar áætlanir, ódýrustu fyrst. Listinn hefur engar síur og passar nú á eina síðu.

Nauðsynlegt leyfi: plans:list

Dæmi um beiðni

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

Dæmi um svar

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

Svarsvið

Field	Tegund	Lýsing
`uuid`	string	Auðkenni áætlunar. Notaðu það sem plan_ uuid eða new_ plan_ uuid.
`cpu`	integer	Fjöldi vCPU
`ram`, `ram_unit`	integer, string	Minni magn og eining þess (MB eða GB)
`disk_space`	integer	Stærð diska í GB
`disk_space_total`	integer	Stærð diska í MB
`transfer`, `transfer_unit`	integer, string	Mánaðarleg gagnaflutningsgjöld og einingin hennar (GB eða TB)
`disk_space_unit`	string	Unit of disk_space (GB)
`includes_ipv4`	boolean	Hvort áætlunin inniheldur opinbera IPv4 netfang. Áætlanir án þess eru aðeins IPv6; IPv4 netfang er hægt að bæta við fyrir $ 2.00 / mánuði.
`monthly_price`, `price`	string	Mánaðarlegt verð í USD sem tugabrot streng. verð er sama gildi.
`hourly_price`	string	Klukkustundarverð í USD sem tugakerfi
`cpu_type_name`	string	CPU tegund, til dæmis Shared. Hleypt fyrir áætlanir án CPU tegund, svo sem GPU áætlun.
`is_active`	boolean	Alltaf satt í þessum lista, vegna þess að óvirkar áætlanir eru ekki skilaðar
`is_gpu`, `gpu_count`, `gpu_model`	boolean, integer, string	Hvort áætlunin felur í sér hollur GPU, hversu margir og hvaða líkan

Svarið segir ekki hvort áætlunin inniheldur IPv4 netfang. 512 MB áætlunin er aðeins IPv6; aðrar núverandi áætlanir innihalda IPv4. Bera saman við verðsíðuna áður en þú velur áætlun fyrir síðu sem verður að vera aðgengileg yfir IPv4.

Kóðar fyrir svörunarstöðu

200	Listi yfir áætlanir sem náðust
403	Vantar eða ógilt API tákn, eða táknið hefur ekki nauðsynleg leyfi

FÁ /api/v1/plans/{uuid}/

Fá upplýsingar um áætlun

Sýnir eina virka áætlun með ofangreindum reitum. Óvirkur eða óþekktur notandi skilar 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": ""
}