Plānu API

Uzskaitiet servera plānus, kurus varat izvietot, izmantojot resursus un cenas. Iztērēt plāna uuid kā plan_ uuid, kad izveidosiet vai mainīsiet servera izmēru.

Galapunkti 2

Bāzes ceļš /api/v1/plans

IEGŪT /api/v1/plans/

Uzskaitīt visus plānus

Atgriež katru aktīvo plānu, lētākais vispirms. Sarakstam nav filtru un šobrīd ietilpst vienā lapā.

Nepieciešamā atļauja: plans:list

Pieprasījuma piemērs

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

Atbildes piemērs

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

Atbildes lauki

Lauks	Tips	Apraksts
`uuid`	string	Plāna identifikators. Izmantojiet to kā plan_ uuid vai new_plan_uuid.
`cpu`	integer	VCPU skaits
`ram`, `ram_unit`	integer, string	Atmiņas apjoms un tā vienība (MB vai GB)
`disk_space`	integer	Diska izmērs GB
`disk_space_total`	integer	Diska izmērs MB
`transfer`, `transfer_unit`	integer, string	Ikmēneša datu pārsūtīšanas pabalsts un tā vienība (GB vai TB)
`disk_space_unit`	string	Diska_telpas vienība (GB)
`includes_ipv4`	boolean	Vai plāns satur publisko IPv4 adresi. Plāni bez viena ir tikai IPv6; par 2.00 ASV dolāriem mēnesī var pievienot IPv4 adresi.
`monthly_price`, `price`	string	Mēneša cena USD kā decimāldaļa. cena ir tāda pati vērtība.
`hourly_price`	string	Stundas cena USD kā decimāldaļas virkne
`cpu_type_name`	string	Procesora tips, piemēram, Koplietojums. Omberted plāniem bez procesora tipa, piemēram GPU plānu.
`is_active`	boolean	Vienmēr taisnība šajā sarakstā, jo neaktīvi plāni nav atgriezti
`is_gpu`, `gpu_count`, `gpu_model`	boolean, integer, string	Vai plāns ietver veltītas GPU, cik daudz, un kāds modelis

Atbildes nav, vai plāns ietver IPv4 adresi. 512 MB plāns ir tikai IPv6, bet citos pašreizējos plānos ir IPv4. Salīdziniet ar cenu lapu pirms izvēlaties vietni, kas sasniedzama IPv4.

Atbildes statusa kodi

200	Veiksmīgi saņemto plānu saraksts
403	Trūkst vai nav spēkā API žetons, vai žetonam trūkst nepieciešamās atļaujas

IEGŪT /api/v1/plans/{uuid}/

Iegūt plāna informāciju

Atgriež vienu aktīvu plānu ar laukiem, kas ir augstāk. Neaktīvs vai nezināms uuid atgriež 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": ""
}