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 ใช้เป็น OS_ version_ 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 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 ไม่มีระบบปฏิบัติการที่มีหมายเลขนี้

เลือกรุ่น

ค้นหารุ่นโดยใช้ชื่อในช่วงเวลาทำงาน แทนที่จะใช้รหัส uuid เพื่อให้การรวมเข้ากับระบบของคุณทำงานต่อไปได้ หลังจากที่รุ่นถูกเพิ่มหรือยกเลิก รายละเอียดการล็อกอินของ root จะถูกส่งอีเมลไปยังเจ้าของบัญชีเมื่อเซิร์ฟเวอร์พร้อมใช้งาน เพิ่มกุญแจ SSH ในการสร้างเซิร์ฟเวอร์ เพื่อล็อกอินด้วยกุญแจแทน