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

குறுக்கப்பட்டது: ஒரு இயக்க முறைமை மட்டுமே காட்டப்படுகிறது மற்றும் எஸ்விஜி குறிமுறை வெட்டப்படுகிறது.

பதில் புலங்கள்

புலங்கள் வகை & விவரக்குறிப்புகள்
id integer இயக்க முறைமை அடையாளம்
name string பகிர்வு பெயர், உதாரணமாக உபுண்டு அல்லது டெபியன்
svg_icon string சின்னத்தின் உள்ளமைந்த எஸ்விஜி குறியாக்கம் (URL அல்ல)
versions array நீங்கள் நிறுவக்கூடிய செயலில் உள்ள பதிப்புகள்
versions[].uuid string சேவையகத்தை உருவாக்கும் போது இயக்க அமைப்பு பதிப்பு uuid ஐ பயன்படுத்து
versions[].name string Version and architecture, for example 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 அந்த அடையாளத்துடன் இயங்குதளம் இல்லை

பதிப்பு தேர்வு

uuid ஐ கடினமாக குறியாக்குவதன் பதிப்புகளை இயக்க நேரத்தில் பெயரால் தேடு, எனவே உங்கள் ஒருங்கிணைப்பு பதிப்புகள் சேர்க்கப்பட்டு அல்லது நீக்கப்பட்டாலும் வேலை செய்யும். சேவையகம் தயாராக இருக்கும் போது root நுழைவு விவரங்கள் கணக்கு உரிமையாளர்களுக்கு மின்னஞ்சல் அனுப்பப்படும்; சேவையகத்தை உருவாக்கும்போது SSH விசையை சேர்த்து ஒரு விசையுடன் நுழையவும்.