VPS.org API

REST API मिसिलीकरण

ब्याकअप API

तपाईँको सर्भर जगेडा सूचीबद्ध गर्नुहोस्, नयाँ जगेडा सुरु गर्नुहोस् र सर्भरबाट सर्भर पूर्वावस्थामा ल्याउनुहोस् ।

अन्तिम बिन्दुहरू 4
आधार मार्ग /api/v1/backups
प्राप्त गर्नुहोस् /api/v1/backups/

सबै ब्याकअपहरू सूचीबद्ध गर्नुहोस्

तपाईँको सबै सर्भरको जगेडा फर्काउँछ, नयाँ पहिलो, पृष्ठ प्रति २५ । त्यहाँ सर्भर फिल्टर छैन: तिनीहरूलाई समूह गर्न सर्भर होस्टनाम प्रयोग गर्नुहोस् ।

अनुमति आवश्यक: backups:list

क्वेरी प्यारामिटरहरू

परिमिति प्रकारहरू आवश्यक छ वर्णन
page integer होइन पृष्ठ नम्बर, १ बाट सुरु

उदाहरण अनुरोध

cURL
Python
JavaScript
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"
    }
  ]
}

प्रतिक्रिया क्षेत्रहरू

फिल्ड प्रकारहरू वर्णन
id integer जगेडा पहिचायक, प्राप्त र पूर्वावस्थामा ल्याउने अन्त्य बिन्दुद्वारा प्रयोग गरियो
server_hostname string सर्भरको होस्टनाम जसबाट जगेडा लिइएको थियो
name string जगेडा सङ्ग्रह फाइल नाम
size_gb number गिगाबाइटमा सङ्कुचित साइज
deletion_date datetime जगेडा स्वचालित रूपमा हटाउने समय
days_remaining integer मेट्ने मितिसम्म बाँकी रहेका पूरा दिनहरू
created_at datetime सिर्जना समय (ISO 8601, UTC)

प्रतिक्रिया स्थिति कोडहरू

200 सफलतापूर्वक जगेडा सूची पुन: प्राप्त गरियो
403 हराइरहेको वा अवैध API टोकन, वा टोकनमा आवश्यक अनुमतिको कमी
प्राप्त गर्नुहोस् /api/v1/backups/{id}/

जगेडा प्राप्त गर्नुहोस्

माथिको फिल्डसँग एउटा जगेडा वस्तु फर्काउँछ ।

curl -X GET "https://admin.vps.org/api/v1/backups/5512/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
पोस्ट /api/v1/servers/{uuid}/backup/

जगेडा सिर्जना गर्नुहोस्

वितरण गरिएको सर्भरको जगेडा लामबद्ध गर्दछ । अनुरोध मुख्य भाग आवश्यक पर्दैन । एउटा पटक समाप्त भएपछि जगेडा सूचीमा देखा पर्दछ, जुन डिस्क प्रयोगमा निर्भर भएर केही मिनेट लिन सक्छ ।

अनुमति आवश्यक: servers:backup

cURL
Python
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"
}

प्रतिक्रिया स्थिति कोडहरू

200 कार्य लाम लगाइएको थियो
400 सर्भर अझै पनि तैनात गरिएको छैन
402 फाइलमा कुनै भुक्तानी विधि छैन, वा भुक्तानी नगरिएका बिलहरू
404 फेला परेन, वा यो अर्को खातासँग सम्बन्धित छ
पोस्ट /api/v1/backups/{id}/restore/

जगेडाबाट सर्भर पूर्वावस्थामा ल्याउनुहोस्

जगेडा लिइएको सर्भर रोक्दछ, जगेडासँग यसको डिस्क अधिलेखन गर्दछ र फेरि सुरु गर्दछ । अनुरोध मुख्य भाग आवश्यक छैन । सर्भर स्थिति लाम हो जब पूर्वावस्थामा ल्याउने चल्दछ ।

अनुमति आवश्यक: 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"
}
चेतावनी: जगेडा लिइएको पछि सर्भरमा लेखिएका सबै कुरा हराउँछ । पूर्वावस्थामा ल्याउने कार्य पूर्वस्थितिमा फर्काउन सकिँदैन ।

प्रतिक्रिया स्थिति कोडहरू

200 कार्य लाम लगाइएको थियो
400 सर्भर अझै पनि तैनात गरिएको छैन
404 फेला परेन, वा यो अर्को खातासँग सम्बन्धित छ

द्रष्टब्य