VPS.org API

Tahirin-kevitra REST API

API backups

Mampiseho ny lisitry ny tahirin-kevitrao momba ny mpizara, manomboka tahirin-kevitra vaovao ary mamerina mpizara iray avy amin'ny iray.

Teboka farany 4
Lalana fototra /api/v1/backups
ALAO /api/v1/backups/

Tanisao ny backup rehetra

Maneho ny tahirin-kevitra avy amin'ny mpizara rehetra, ny vaovao indrindra aloha, 25 isan-pejy. Tsy misy sivana mpizara: ampiasaina ny server_hostname hanasongadinana azy ireo.

Mila alalana: backups:list

Paramètres de requête

Mpizahaky ny macro Karazana ilaina Fanoritsoritana
page integer Tsy misy Isan'ny pejy, manomboka amin'ny 1

Ohatra amin'ny fangatahana

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

Ohatra amin'ny Valiny

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

Saha Valiny

Field Karazana Fanoritsoritana
id integer Mpamantatra ny tahirin-kevitra, ampiasaina amin'ny endpoints'ny get sy restore
server_hostname string Anaran'ny mpizara izay nandraisana ilay tahirin-kevitra
name string Anaran'ny arsiva
size_gb number Haben'ny fafàna (gigabyte)
deletion_date datetime Ny fotoana fafàna hoazy ny tahirin-kevitra
days_remaining integer Andro manontolo sisa tavela alohan'ny fandefasana ny fandefasana
created_at datetime Fotoana namoronana (ISO 8601, UTC)

Kaody momba ny satan'ny valiny

200 Nahazo ny lisitry ny tahirin-kevitra
403 Token API tsy misy na tsy mitombina, na tsy manana ny fahazoan-dàlana ilaina ilay token
ALAO /api/v1/backups/{id}/

Maka tahirin-kevitra

Maneho zavatra iray misy tahirin-kevitra iray miaraka amin'ireo sehatr'asa etsy ambony.

curl -X GET "https://admin.vps.org/api/v1/backups/5512/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
POST /api/v1/servers/{uuid}/backup/

Hamorona tahirin-kevitra

Mametraka anaty filaharana ny tahirin-kevitra iray amin'ny mpizara iray efa napetraka. Tsy ilaina ny vatana. Hiseho anatin'ny lisitra ny tahirin-kevitra rehefa vita, izay mety haharitra minitra maro arakaraka ny fampiasana ny kapila.

Mila alalana: 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())

Ohatra amin'ny Valiny

{
  "message": "Backup queued successfully"
}

Kaody momba ny satan'ny valiny

200 Voasoratra anatin'ny filaharana ilay asa
400 Tsy mbola napetraka ilay mpizara
402 Tsy misy fomba fandoavam-bola ao amin'ny raki-tahiry, na tsy misy vola tsy voaloa
404 Tsy hita, na an'ny kaonty hafa izy io
POST /api/v1/backups/{id}/restore/

Mametra ny mpizara iray avy amin'ny tahirin-kevitra

Manajanona ny mpizara izay nandraisana ny tahirin-kevitra, manova ny kapila misy azy amin'ny tahirin-kevitra, ary manokatra azy indray. Tsy mila vatana ny fangatahana. Miandry ny fanarenana ny mpizara.

Mila alalana: 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"
}
Fampilazana: Tsy hita ny zavatra voasoratra teo amin'ny mpizara taorian'ny nandraisana ilay tahirin-kevitra. Tsy azo atao ny manafoana ny famerenana.

Kaody momba ny satan'ny valiny

200 Voasoratra anatin'ny filaharana ilay asa
400 Tsy mbola napetraka ilay mpizara
404 Tsy hita, na an'ny kaonty hafa izy io

Fanamarihana