VPS.org API

REST API Documentation

API αντιγράφων ασφαλείας

Λίστα των αντιγράφων ασφαλείας του διακομιστή σας, ξεκινήστε ένα νέο backup και αποκαταστήστε έναν διακομιστή από ένα.

Τελικά σημεία 4
Βασική διαδρομή /api/v1/backups
ΠΑΙΡΝΩ /api/v1/backups/

Λίστα όλων των αντιγράφων ασφαλείας

Επιστρέφει τα αντίγραφα ασφαλείας όλων των διακομιστών σας, νεότερο πρώτα, 25 ανά σελίδα. Δεν υπάρχει φίλτρο διακομιστή: χρήση του server_hostname για την ομάδα τους.

Απαιτείται άδεια: backups:list

Παράμετροι ερωτήματος

Parameter Τύπος Υποχρεούμαι Description
page integer No Αριθμός σελίδας, ξεκινώντας από το 1

Παράδειγμα Αιτήματος

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"
    }
  ]
}

Πεδία απόκρισης

Πεδίο Τύπος Description
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"
POST /api/v1/servers/{uuid}/backup/

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

Παρακολουθεί ένα backup ενός αναπτυσσόμενου διακομιστή. Δεν απαιτείται σώμα αιτήματος. Το 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 Δεν βρέθηκε ή ανήκει σε άλλο λογαριασμό
POST /api/v1/backups/{id}/restore/

Επαναφορά εξυπηρετητή από ένα 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"
}
Προειδοποίηση: Όλα όσα γράφτηκαν στον διακομιστή μετά την λήψη των αντιγράφων ασφαλείας χάνονται.

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

200 Η δράση ήταν σε αναμονή.
400 Ο διακομιστής δεν έχει αναπτυχθεί ακόμα
404 Δεν βρέθηκε ή ανήκει σε άλλο λογαριασμό

Σημειώσεις