백업 API

모든 백업 목록 보기

모든 서버의 백업을 최신 순서대로 페이지당 25개씩 반환합니다. 서버 필터가 없습니다. server_hostname 를 사용하여 그룹화합니다.

필요한 권한: backups:list

쿼리 매개변수

예시 요청

curl -X GET "https://admin.vps.org/api/v1/backups/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

import requests

url = "https://admin.vps.org/api/v1/backups/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.get(url, headers=headers)
for backup in response.json()["results"]:
    print(backup["id"], backup["server_hostname"], backup["created_at"])

const response = await fetch('https://admin.vps.org/api/v1/backups/', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
});

const data = await response.json();
console.log(data.results);

예시 답변

{
  "count": 96,
  "next": "https://admin.vps.org/api/v1/backups/?page=2",
  "previous": null,
  "results": [
    {
      "id": 5512,
      "server_hostname": "web-01",
      "name": "vzdump-qemu-1042-2026_09_14-16_44_10.vma.zst",
      "size_gb": 3.12,
      "deletion_date": "2026-09-21T20:45:40.697512Z",
      "days_remaining": 6,
      "created_at": "2026-09-14T20:45:40.699494Z"
    }
  ]
}

응답 필드

응답 상태 코드

백업 받기

위의 필드를 가진 하나의 백업 객체를 반환합니다.

curl -X GET "https://admin.vps.org/api/v1/backups/5512/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

백업 만들기

배포된 서버의 백업을 대기열에 놓습니다. 요청 본문이 필요하지 않습니다. 백업이 완료되면 목록에 나타납니다. 디스크 사용량에 따라 몇 분이 걸릴 수 있습니다.

필요한 권한: servers:backup

curl -X POST "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/backup/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

import requests

server_uuid = "8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b"
url = f"https://admin.vps.org/api/v1/servers/{server_uuid}/backup/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.post(url, headers=headers)
print(response.json())

예시 답변

{
  "message": "Backup queued successfully"
}

응답 상태 코드

백업에서 서버 복원

백업을 취한 서버를 중지하고, 백업으로 디스크를 덮어쓰고 다시 시작합니다. 요청 본문이 필요하지 않습니다. 복원이 실행되는 동안 서버 상태는 큐입니다.

필요한 권한: backups:restore

curl -X POST "https://admin.vps.org/api/v1/backups/5512/restore/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "message": "Backup restore queued. The server will be stopped, restored, and restarted.",
  "backup": "vzdump-qemu-1042-2026_09_14-16_44_10.vma.zst",
  "job_id": "b6f1c7e2-3a4d-4f5e-8b9c-0d1e2f3a4b5c"
}

응답 상태 코드

메모

• 백업은 자동으로 만료됩니다. 보유 기간을 가정하는 대신 deletion_date 또는 days_remaining 를 읽습니다.
• API는 백업을 삭제할 수 없습니다.
• 스냅샷은 자체 엔드포인트가 있는 별도의 리소스이며 여기에 나열되지 않습니다. 스냅샷 API