API Fa'asao

Lisi uma o faaleoleo

Tuʻu le backup o au 'au'aunaga uma, o le sili ona fou muamua, 25 i le 'upega tafa'ilagi. E leai se siaki 'au'aunaga: faʻaaoga le server_hostname e faʻavasega ai.

Manaomia le aia tatau: backups:list

Fa'asologa o Fesili

Talosaga Fa'ata'ita'i

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

Tali Fa'ata'ita'i

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

Fanua Tali

Fa'ailoga o Tulaga o Tali

Faʻataga se backup

Toetū se mea faʻaleoleo ma le itu i luga.

curl -X GET "https://admin.vps.org/api/v1/backups/5512/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Faʻatonu se backup

Fa'asolo i le 'file' se fa'afaigaluegaina o se 'auaunaga'. E le mana'omia se tino talosaga. O le fa'afaigaluegaina o le a fa'aalia i le lisi pe a mae'a, e mafai ona 'ai ni minute e fa'atatau i le fa'aaogaina o le diski.

Manaomia le aia tatau: 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())

Tali Fa'ata'ita'i

{
  "message": "Backup queued successfully"
}

Fa'ailoga o Tulaga o Tali

Toe faʻaleleia se faitotoʻa mai se faʻatupeina

Faʻatapulaʻa le 'au'aunaga na faia ai le backup, toe tusia lona diski ma le backup ma toe amataina. E le manaʻomia se tino talosaga. O le tulaga o le 'au'aunaga o le 'queue' a o'o mai le toe faʻaleleia.

Manaomia le aia tatau: 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"
}

Fa'ailoga o Tulaga o Tali

Faʻamatalaga

• E faʻatapulaʻaina e le otometi le taimi e faʻatapulaʻaina ai backups. faitau le deletion_date poʻo le days_remaining e aunoa ma le manatuaina o se taimi teuina.
• E le mafai e le API ona faʻaleaogaina se faʻatupeina.
• O ata tifaga o se punaoa ese ma o latou lava faʻaiuga ma e le o lisiina iinei. API Ata Pupuu