VPS.org API

REST API დოკუმენტაცია

ოპერაციული სისტემების API

ჩამოთვალეთ ოპერაციული სისტემები, რომლებიც შეგიძლიათ დააყენოთ და მათი ვერსიები. სერვერის შექმნისას ვერსიის uuid გადაეცით როგორც ოპერაციული_სივრცის_ვერსია_uuid.

საბოლოო წერტილები 2
ბაზისური გზა /api/v1/operating-systems
მიიღეთ /api/v1/operating-systems/

ოპერაციული სისტემების სია

ოპერაციული სისტემის ყველა აქტიური ვერსიის დაბრუნება. სიაში ფილტრი არ არის.

საჭიროა უფლება: operating-systems:list

მაგალითის მოთხოვნა

cURL
Python
JavaScript
curl -X GET "https://admin.vps.org/api/v1/operating-systems/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
import requests

url = "https://admin.vps.org/api/v1/operating-systems/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.get(url, headers=headers)
for os_entry in response.json()["results"]:
    for version in os_entry["versions"]:
        print(os_entry["name"], version["name"], version["uuid"])
const response = await fetch('https://admin.vps.org/api/v1/operating-systems/', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
});

const data = await response.json();
for (const os of data.results) {
  for (const version of os.versions) {
    console.log(os.name, version.name, version.uuid);
  }
}

მაგალითის პასუხი

{
  "count": 6,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": 1,
      "name": "Ubuntu",
      "svg_icon": "<svg ...>",
      "versions": [
        {
          "uuid": "2fdead8f-81a2-4a23-9a81-0cf969fe1266",
          "name": "22.04 LTS x64",
          "os_name": "Ubuntu",
          "os_svg_icon": "<svg ...>",
          "is_active": true
        },
        {
          "uuid": "c3418f90-80a0-4e00-a7e1-d0ab1822b941",
          "name": "24.04 LTS x64",
          "os_name": "Ubuntu",
          "os_svg_icon": "<svg ...>",
          "is_active": true
        }
      ]
    }
  ]
}

შეკუმშული: მხოლოდ ერთი ოპერაციული სისტემა არის ნაჩვენები და SVG მარკერი შეკუმშულია.

პასუხის ველები

ველი ტიპი აღწერა
id integer ოპერაციული სისტემის იდენტიფიკატორი
name string დისტრიბიუციის სახელი, მაგალითად Ubuntu ან Debian
svg_icon string SVG ლოგოს შიგნითა მარკერი (URL არ არის)
versions array აქტიური ვერსიები, რომელთა დაყენებაც შეგიძლიათ
versions[].uuid string გამოყენება როგორც ოპერაციული_ სისტემის_ ვერსია_ uuid სერვერის შექმნისას
versions[].name string ვერსია და არქიტექტურა, მაგალითად 24.04 LTS x64
versions[].os_name, versions[].os_svg_icon string მშობელი ოპერაციული სისტემის სახელი და ხატულა
versions[].is_active boolean ვერსია შეიძლება გამოყენებულ იქნას თუ არა ახალი სერვერებისთვის

პასუხის სტატუსის კოდები

200 ოპერაციული სისტემების წარმატებით მიღებული სია
403 API ტოკენი არ არის ან არასწორია, ან ტოკენს არ აქვს საჭირო უფლება
მიიღეთ /api/v1/operating-systems/{id}/

ოპერაციული სისტემის მიღება

უკან ბრუნავს ერთ ოპერაციულ სისტემას და მის აქტიურ ვერსიას ზემოთ მოცემული ველით.

curl -X GET "https://admin.vps.org/api/v1/operating-systems/1/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

პასუხის სტატუსის კოდები

200 წარმატება
404 ოპერაციული სისტემა არ არსებობს ამ ID- ით

ვერსიის არჩევა

ვერსიების ძებნა სახელის მიხედვით uuid- ის მკაცრი კოდირების ნაცვლად, ასე რომ თქვენი ინტეგრაცია მუშაობს ვერსიების დამატებისას ან გაშვებისას. root- ის ლოგინზე შესვლის დეტალები ელფოსტით მიეწოდება ანგარიშის მფლობელს სერვერის მზადყოფნისას; სერვერის შექმნისას SSH კოდის დამატება, რომ ჩასვლა კოდის საშუალებით მოხდეს.