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 상위 운영 체제의 이름과 아이콘
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 키를 추가하여 키로 로그인하세요.