VPS.org API

Faʻamatalaga o le REST API

API Ata Pupuu

Faʻatonu ata tifaga o se 'au'aunaga, lisiina ma faʻaleaogaina na e le manaʻomia.

Fa'ai'uga 4
Ala Autu /api/v1/snapshots
MAUA /api/v1/snapshots/

Lisi Ata Uma

Toe foʻi i ata tifaga i lau teugatupe, o le sili ona fou muamua, 25 i le itulau.

Manaomia le aia tatau: snapshots:list

Talosaga Fa'ata'ita'i

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);

Tali Fa'ata'ita'i

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

Fanua Tali

Aoga Ituaiga Faʻamatalaga
uuid string Faailoga tagata o le ata (32 karapa hexadecimal, leai se faaupuga)
label string Faʻatonuina le igoa pe a faia le ata
server_hostname string Le igoa o le 'auaunaga o le' au'aunaga na faia ai le ata, po'o le 'null' pe a le' i iai le 'au'aunaga
ready boolean True pe a maeʻa le ata tifaga
deleting boolean True pe a o le faʻaigoaina o se faʻaigoaina
created_at datetime Taimi o le faia (ISO 8601, UTC)
size_gb number Le tele o le faʻaosoina i gigabytes
MAUA /api/v1/snapshots/{uuid}/

Faʻataga se ata tifaga

Tuʻu se mea i luga o le ata i le itu taumatau. Faʻaaoga mo le suʻesuʻega o le taimi nei pe a uma ona faia se ata.

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

Faʻatonu se ata

Fa'asolo i le pito i luga o se ata o se 'au'aunaga ua fa'atino ma toe fo'i i le uuid o le ata fou. E lisi atu le ata i le taimi lava e tasi ma le ready fa'atulaga i le false.

Manaomia le aia tatau: servers:snapshot

Talosaga mo Fa'atulagaga o le Tino

Paramita Ituaiga Mana'omia Faʻamatalaga
action string Ioe E tatau ona o se ata pu
snapshot_label string Ioe Se igoa e iloa ai le ata tifaga e ala i
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"])

Tali Fa'ata'ita'i

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

Fa'ailoga o Tulaga o Tali

200 O le gaioiga ua faʻasolo i le laina
400 action po o snapshot_label e le maua, po o le 'auaunaga e le' ai le 'au'aunaga
402 E leai se auala totogi i le faila, po o faʻamatalaga le totogiina
404 E le maua, po o e fai ma sui o se isi teugatupe
TAPE'E /api/v1/snapshots/{uuid}/

Suʻe se ata

Faʻasolo i le faʻasolo le ata tifaga mo le faʻaleaogaina tumau. O le faʻaleaogaina o le a moni seia oo ina oti.

Manaomia le aia tatau: snapshots:delete

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

Fa'ailoga o Tulaga o Tali

202 Faʻatonu le talosaga
404 E le maua, po o e fai ma sui o se isi teugatupe

Faʻamatalaga