Planer API

List opp tjenerplanene du kan bruke med deres ressurser og priser. Send en uuid- plan som plan_ uuid når du oppretter eller endrer størrelse på en tjener.

Endepunkter 2

Basissti /api/v1/plans

BLI /api/v1/plans/

List opp alle planer

Returnerer alle aktive planer, billigste først. Lista har ingen filtre og passer for tiden på en side.

Påkrevd tillatelse: plans:list

Eksempelforespørsel

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

Eksempelsvar

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

Svarfelt

Felt	Type	Beskrivelse
`uuid`	string	Planidentifikator. Bruk det som plan_ uuid eller new_ plan_ uuid.
`cpu`	integer	Antall vCPUer
`ram`, `ram_unit`	integer, string	Minnemengde og enhetens enhet (MB eller GB)
`disk_space`	integer	Diskstørrelse i GB
`disk_space_total`	integer	Diskstørrelse i MB
`transfer`, `transfer_unit`	integer, string	Månedlig kvote for overføring av data og dens enhet (GB eller TB)
`disk_space_unit`	string	Enhet for diskplass (GB)
`includes_ipv4`	boolean	Om planen inneholder en offentlig IPv4- adresse. Planer uten en er bare IPv6. En IPv4- adresse kan legges til for $200/ måned.
`monthly_price`, `price`	string	Månedlig pris i USD som desimalverdi. Prisen er den samme verdien.
`hourly_price`	string	Timepris i USD som desimal
`cpu_type_name`	string	CPU- type, for eksempel Delt. Tildelt for planer uten CPU- type, slik som GPU- plan.
`is_active`	boolean	Dette er alltid satt til rette i denne lista, fordi ikke- mobile planer ikke blir returnert
`is_gpu`, `gpu_count`, `gpu_model`	boolean, integer, string	Om planen inneholder dedikerte GPU- er, hvor mange og hvilken modell

Svaret sier ikke om en plan inneholder en IPv4- adresse. Planen på 512 MB er bare IPv6, de andre gjeldende planene inkluderer IPv4. Sammenlikne med prissiden før du velger en plan for et nettsted som må være tilgjengelig over IPv4.

Svarstatuskoder

200	Liste over planlagte prosjekter ble vellykket hentet
403	Mangler eller er ugyldig API- symbol, eller symbolet mangler tillatelse

BLI /api/v1/plans/{uuid}/

Få plandetaljer

Gir en aktiv plan med feltene over. En inaktiv eller ukjent uuid gir 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": ""
}