VPS.org API

REST API Documentation

Operatsioonisüsteemide API

Loetlege operatsioonisüsteemid, mida saate paigaldada ja nende versioonid. Kui loote serveri, siis läbige versiooni uid kui operatsiooni_system_version_uid.

Lõpp-punktid 2
Baasrada /api/v1/operating-systems
SAA /api/v1/operating-systems/

Operatsioonisüsteemide nimekiri

Tagastab iga operatsioonisüsteemi aktiivse versiooniga. Nimekirjal pole filtreid.

Nõutav luba: operating-systems:list

Näidistaotlus

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

Näidisvastus

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

Lühendatud: näidatakse ainult ühte operatsioonisüsteemi ja SVG märgistus on lõigatud.

Vastuseväljad

Väli Tüüp Description
id integer Operatsioonisüsteemi tunnus
name string Levitusnimi, näiteks Ubuntu või Debian
svg_icon string Logo SVG- märgistus (mitte URL)
versions array Aktiivne versioon, mida saab paigaldada
versions[].uuid string Kasutatakse serveri loomisel operatsiooni_süsteemi_version_uudina
versions[].name string Versioon ja arhitektuur, näiteks 24.04 LTS x64
versions[].os_name, versions[].os_svg_icon string Emaettevõtte operatsioonisüsteemi nimi ja ikoon
versions[].is_active boolean Kas versiooni saab kasutada uute serverite puhul

Vastuse olekukoodid

200 Edukalt hangitud operatsioonisüsteemide nimekiri
403 Puuduv või vigane API märgis või märgil puudub nõutav luba
SAA /api/v1/operating-systems/{id}/

Hangi operatsioonisüsteem

Tagastab ühe operatsioonisüsteemi ja selle aktiivsed versioonid koos eespool nimetatud väljadega.

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

Vastuse olekukoodid

200 Edukas
404 Selle ID-ga operatsioonisüsteem puudub

Versiooni valimine

Otsi versioone nime järgi töölaual, mitte aga uudi kõvaks kodeerimine, nii et sinu integratsioon jätkab tööd, kui versioonid lisatakse või pensionile. Juure sisselogimise üksikasjad saadetakse konto omanikule, kui server on valmis; lisa SSH võti, kui luuakse server, et sisse logida võtmega.