VPS.org API

REST API Documentation

API στιγμιότυπων

Πάρτε στιγμιότυπα με επισήμανση ενός διακομιστή, να τις απαριθμήσετε και να διαγράψετε αυτές που δεν χρειάζεστε πλέον.

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

Λίστα όλων των στιγμιότυπων

Επιστρέφει τις φωτογραφίες στο λογαριασμό σας, νεότερες πρώτα, 25 ανά σελίδα.

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

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

cURL
Python
JavaScript
curl -X GET "https://admin.vps.org/api/v1/snapshots/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
import requests

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

response = requests.get(url, headers=headers)
for snapshot in response.json()["results"]:
    print(snapshot["uuid"], snapshot["label"], snapshot["ready"])
const response = await fetch('https://admin.vps.org/api/v1/snapshots/', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
});

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

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

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "3f9a1c0e5b7d4e2f8a6c1b3d5e7f9a0b",
      "label": "before-upgrade",
      "server_hostname": "web-01",
      "ready": true,
      "deleting": false,
      "created_at": "2026-09-14T18:30:00.000000Z",
      "size_gb": 3.4
    }
  ]
}

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

Πεδίο Τύπος Description
uuid string Αναγνωριστικό σνάπσον (32 δεκαεξαεξαίμαχοι χαρακτήρες, χωρίς ενστάσεις)
label string Ετικέτα που δόθηκε όταν δημιουργήθηκε το στιγμιότυπο
server_hostname string Όνομα υπολογιστή του εξυπηρετητή το στιγμιότυπο ελήφθη από, ή δεν υπάρχει πλέον, εάν ο εξυπηρετητής αυτός δεν υπάρχει
ready boolean Είναι αλήθεια, μόλις τελειώσει το στιγμιότυπο.
deleting boolean Είναι αλήθεια ότι η διαγραφή βρίσκεται σε εξέλιξη
created_at datetime Χρόνος δημιουργίας (ISO 8601, UTC)
size_gb number Συμπιεσμένο μέγεθος σε γιγαμπάιτ
ΠΑΙΡΝΩ /api/v1/snapshots/{uuid}/

Πάρε μια φωτογραφία.

Επιστρέφει ένα αντικείμενο στιγμιότυπο με τα παραπάνω πεδία. Χρησιμοποιήστε το για να δημοσκοπήσετε έτοιμο μετά τη δημιουργία ενός στιγμιότυπου.

curl -X GET "https://admin.vps.org/api/v1/snapshots/3f9a1c0e5b7d4e2f8a6c1b3d5e7f9a0b/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
POST /api/v1/servers/{uuid}/snapshot/

Δημιουργία μιας φωτογραφίας

Ανακρίνει μια φωτογραφία ενός αναπτυσσόμενου διακομιστή και επιστρέφει το νέο στιγμιότυπο uuid. Το στιγμιότυπο είναι καταχωρημένο αμέσως με έτοιμο σετ σε λάθος.

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

Παράμετροι σώματος αιτήματος

Parameter Τύπος Υποχρεούμαι Description
action string Ναί Πρέπει να είναι στιγμιότυπο.
snapshot_label string Ναί Μια ετικέτα για την αναγνώριση της φωτογραφίας από
cURL
Python
curl -X POST "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/snapshot/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "snapshot", "snapshot_label": "before-upgrade"}'
import requests

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

response = requests.post(url, headers=headers, json=data)
print(response.json()["snapshot_uuid"])

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

{
  "message": "Snapshot queued successfully",
  "snapshot_uuid": "3f9a1c0e5b7d4e2f8a6c1b3d5e7f9a0b"
}

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

200 Η δράση ήταν σε αναμονή.
400 action ή στιγμιότυπου_label λείπει, ή ο εξυπηρετητής δεν έχει αναπτυχθεί ακόμα
402 Δεν υπάρχει μέθοδος πληρωμής στο αρχείο ή μη καταβληθέντα τιμολόγια
404 Δεν βρέθηκε ή ανήκει σε άλλο λογαριασμό
ΔΙΑΓΡΑΦΩ /api/v1/snapshots/{uuid}/

Διαγραφή μιας φωτογραφίας

Αναλαμβάνει την λήψη για μόνιμη διαγραφή. Η διαγραφή είναι αληθινή μέχρι να χαθεί.

Απαιτείται άδεια: snapshots:delete

curl -X DELETE "https://admin.vps.org/api/v1/snapshots/3f9a1c0e5b7d4e2f8a6c1b3d5e7f9a0b/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "message": "Snapshot deletion queued"
}

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

202 Δεκτή: η αίτηση ήταν σε σειρά αναμονής
404 Δεν βρέθηκε ή ανήκει σε άλλο λογαριασμό

Σημειώσεις