बैकअप एपीआई

सभी बैकअप की सूची बनाएं

आपके सभी सर्वरों के बैकअप बताता है, नए, 25 प्रति पृष्ठ पर 25. कोई सर्वर फिल्टर नहीं है: सर्वर-host_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"
}

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

टिप्पणी

• बैकअप की मियाद स्वतः ख़त्म हो चुकी है. अद्यतन या दिनों को मिटाना (_u)
• एपीआई फ़ाइल वैध नहीं है
• स्नेपशॉट अपने स्वयं के अंत- बिन्दुओं के साथ एक अलग संसाधन हैं और यहाँ सूचीबद्ध नहीं हैं. स्नैपशॉट एपीआई