VPS.org API

REST API փաստաթղթավորում

Օպերացիոն համակարգերի API

Ցուցադրել հնարավոր օպերացիոն համակարգերը և դրանց տարբերակները։ Սերվեր ստեղծելիս uuid-ը փոխանցել որպես operating_system_version_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 Օգտագործել որպես սերվեր ստեղծելիս operating_system_version_uuid
versions[].name string Վերջնական տարբերակ և ճարտարապետություն, օրինակ 24.04 LTS x64
versions[].os_name, versions[].os_svg_icon string Name and icon of the parent operating system
versions[].is_active boolean Արդյո՞ք տարբերակը կարող է օգտագործվել նոր սերվերների համար

Պատասխանի կարգավիճակի կոդեր

200 Սխալ մուտքագրված Օպերացիոն համակարգերի ցուցակը
403 Հաշվառված կամ օրինական API token-ը բացակայում է, կամ token-ը չունի անհրաժեշտ թույլտվություն
ՍՏԱՆԱԼ /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 կոդը սերվերի ստեղծման ժամանակ, որպեսզի մուտքագրվեք կոդով։