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"

Δημιουργία αντιγράφων ασφαλείας

Παρακολουθεί ένα backup ενός αναπτυσσόμενου διακομιστή. Δεν απαιτείται σώμα αιτήματος. Το backup εμφανίζεται στη λίστα μόλις έχει τελειώσει, η οποία μπορεί να πάρει αρκετά λεπτά ανάλογα με τη χρήση του δίσκου.

Απαιτείται άδεια: 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"
}

Κωδικοί κατάστασης απόκρισης

Αυτόματες αντιγράφων ασφαλείας προγράμματος

Turns daily or weekly automatic backups on or off, the same setting as the Backups tab in the control panel. GET returns the current schedule. PATCH (or PUT) changes any of the fields below. Turning backups on queues a first backup straight away. Each backup is kept for 7 days.

Απαιτείται άδεια: servers:backup

curl -X PATCH "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/backup-settings/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"enabled": true, "plan": "daily", "window": "8-12"}'

import requests

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

response = requests.patch(url, headers=headers, json={"enabled": True, "plan": "daily", "window": "8-12"})
print(response.json())

Παράδειγμα απάντησης

{
  "enabled": true,
  "plan": "daily",
  "window": "8-12",
  "retention_days": 7,
  "price_percent_of_plan": 30,
  "last_backup_at": "2026-10-28T23:33:50Z",
  "backups_kept": 1
}

Κωδικοί κατάστασης απόκρισης

Επαναφορά εξυπηρετητή από ένα Backup

Σταματάει τον εξυπηρετητή που πήραν το εφεδρικό από, αντιγράφει το δίσκο του με το εφεδρικό και ξεκινάει πάλι. Δεν απαιτείται σώμα αιτήματος. Η κατάσταση του διακομιστή είναι ουρά ενώ η αποκατάσταση τρέχει.

Απαιτείται άδεια: 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"
}

Κωδικοί κατάστασης απόκρισης

Σημειώσεις

• Διαβάστε διαγραφή_ημερομηνία ή ημέρες_μένουν αντί να αναλάβει μια περίοδο διατήρησης.
• Το API δεν μπορεί να διαγράψει ένα εφεδρικό.
• Οι φωτογραφίες είναι ένας ξεχωριστός πόρος με τα δικά τους τελικά σημεία και δεν αναφέρονται εδώ. API στιγμιότυπων