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 ឈ្មោះ​ការ​ចែកចាយ ឧទាហរណ៍ អ៊ូប៊ុនទូ ឬ ដេបៀន
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 ឈ្មោះ និង​រូបតំណាង​របស់​ប្រព័ន្ធ​ប្រតិបត្តិការ​មេ
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 គ្មាន​ប្រព័ន្ធ​ប្រតិបត្តិការ​ដែល​មាន​លេខ​សម្គាល់​នោះ​ទេ

ការ​ជ្រើស​កំណែ

មើល​កំណែ​ឡើង​តាម​ឈ្មោះ​នៅ​ពេល​រត់​ជំនួស​ឲ្យ​ hardcoding uuid ដូច្នេះ​ការ​រួម​បញ្ចូល​របស់​អ្នក​នៅតែ​ធ្វើការ​នៅពេល​ដែល​កំណែ​ត្រូវ​បាន​បន្ថែម ឬ​ដក​ចេញ ។ សេចក្ដី​លម្អិត​ការ​ចូល Root ត្រូវ​បាន​ផ្ញើ​អ៊ីមែល​ទៅ​ម្ចាស់​គណនី​នៅពេល​ដែល​ម៉ាស៊ីន​បម្រើ​រួចរាល់ បន្ថែម​កូនសោ SSH ពេល​បង្កើត​ម៉ាស៊ីន​បម្រើ​ដើម្បី​ចូល​ជាមួយ​កូនសោ​ជំនួស ។