API dei piani

Elenca i piani server che puoi distribuire, con le loro risorse e i loro prezzi. Passa l'uuid di un piano come plan_uuid quando crei o ridimensioni un server.

Punti finali 2

Percorso di base /api/v1/plans

OTTENERE /api/v1/plans/

Elenca tutti i piani

Restituisce ogni piano attivo, il più economico prima. La lista non ha filtri e attualmente si adatta su una pagina.

Autorizzazione richiesta: plans:list

Richiesta di esempio

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

Esempio di risposta

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

Campi di risposta

Campo	Tipo	Designazione delle merci
`uuid`	string	Identifier del piano. Usalo come plan_uuid o new_plan_uuid.
`cpu`	integer	Numero di vCPU
`ram`, `ram_unit`	integer, string	Quantità di memoria e sua unità (MB o GB)
`disk_space`	integer	Dimensione disco in GB
`disk_space_total`	integer	Dimensione disco in MB
`transfer`, `transfer_unit`	integer, string	Quota mensile di trasferimento dei dati e sua unità (GB o TB)
`disk_space_unit`	string	Unità di spazio disco (GB)
`includes_ipv4`	boolean	Indica se il piano include un indirizzo IPv4 pubblico. I piani senza un indirizzo IPv6 sono solo; un indirizzo IPv4 può essere aggiunto per $2,00/mese.
`monthly_price`, `price`	string	Prezzo mensile in USD come stringa decimale. prezzo è lo stesso valore.
`hourly_price`	string	Prezzo orario in USD come stringa decimale
`cpu_type_name`	string	Tipo di CPU, per esempio Shared. Omessa per i piani senza tipo di CPU, come il piano GPU.
`is_active`	boolean	Sempre vero in questa lista, perché i piani inattivi non vengono restituiti
`is_gpu`, `gpu_count`, `gpu_model`	boolean, integer, string	Se il piano include GPU dedicate, quanti, e quale modello

La risposta non dice se un piano include un indirizzo IPv4. Il piano 512 MB è solo IPv6; gli altri piani attuali includono IPv4. Confronta con la pagina dei prezzi prima di scegliere un piano per un sito che deve essere raggiungibile su IPv4.

Codici di stato della risposta

200	Elenco dei piani recuperati con successo
403	Token API mancante o non valido, o il token non ha il permesso richiesto

OTTENERE /api/v1/plans/{uuid}/

Ottieni i dettagli del piano

Restituisce un piano attivo con i campi sopra riportati. Un uuid inattivo o sconosciuto restituisce 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": ""
}