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 સર્વર બનાવતી વખતે ઓપરેટિંગ_સિસ્ટમ_વર્ઝન_uuid તરીકે વાપરો
versions[].name string આવૃત્તિ અને આર્કિટેક્ચર, ઉદાહરણ તરીકે ૨૪.૦૪ LTS x૬૪
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 ને હાર્ડકોડીંગ કરવાને બદલે રનટાઇમ પર નામ દ્વારા આવૃત્તિઓ જુઓ, તેથી તમારું સંકલન કામ કરવાનું ચાલુ રાખે છે જ્યારે આવૃત્તિઓ ઉમેરાયેલ હોય અથવા નિવૃત થયેલ હોય. રુટ પ્રવેશ વિગતો ખાતા માલિકને ઇમેઇલ કરે છે જ્યારે સર્વર તૈયાર હોય; SSH કી ઉમેરો જ્યારે સર્વરને બનાવો ત્યારે તેની જગ્યાએ કી સાથે પ્રવેશ કરવા માટે.