VPS.org API

REST API dokumentáció

Operációs rendszerek API-ja

Listázza az operációs rendszereket, melyeket telepíthet és azok verzióit. Adja meg a verzió uiedet operációs_system_version_uuidként, amikor létrehoz egy szervert.

Végpontok 2
Alapút /api/v1/operating-systems
KAP /api/v1/operating-systems/

Üzemeltető rendszerek listája

Minden operációs rendszert visszaad az aktív verzióival. A listában nincsenek szűrők.

Szükséges engedély: operating-systems:list

Példa kérés

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

Példaválasz

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

Rövidített: csak egy operációs rendszer jelenik meg, és az SVG jelölés el van vágva.

Válaszmezők

Mező Típus Leírás
id integer Üzemeltetési rendszer azonosítója
name string Eloszlási név, például Ubuntu vagy Debian
svg_icon string A logó SVG jelölése (nem URL)
versions array Aktív verziók telepíthető
versions[].uuid string A kiszolgáló létrehozásakor operációs_system_version_uuuidként használható
versions[].name string Verzió és építészet, például 24.04 LTS x64
versions[].os_name, versions[].os_svg_icon string Az anyavállalati operációs rendszer neve és ikonja
versions[].is_active boolean A verzió használható- e új szerverekhez

Válasz állapotkódok

200 Sikeresen letöltött operációs rendszerek listája
403 Hiányzó vagy érvénytelen API token, vagy a token hiányzik a szükséges engedély
KAP /api/v1/operating-systems/{id}/

Működtető rendszer

Visszaadja egy operációs rendszer és annak aktív verziói, a fenti mezők.

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

Válasz állapotkódok

200 Siker
404 Nincs operációs rendszer ezzel az azonosítóval.

Verzió kiválasztása

Keresse meg a verziókat név szerint a runtime helyett a hardcoding egy uud, így az integráció továbbra is működik, ha a verziók hozzáadása vagy nyugdíjba. Root login részleteket e-mailben a számla tulajdonos, ha a szerver kész; adjunk hozzá egy SSH kulcsot, amikor a szerver létrehozása a kulcs helyett.