VPS.org API

Tahirin-kevitra REST API

API Sary Misongadina

Maka sary mihetsika misy marika avy amin'ny mpizara iray, mametraka azy ireo ho lisitra ary manafoana ireo tsy ilainao intsony.

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

Tanisao ny sary rehetra

Maneho ireo sary an-tsary ao amin'ny kaontinao, ny vaovao indrindra aloha, 25 isaky ny pejy.

Mila alalana: snapshots:list

Ohatra amin'ny fangatahana

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

Ohatra amin'ny Valiny

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

Saha Valiny

Field Karazana Fanoritsoritana
uuid string Mpamantatra ny sary (marika hexadecimal 32, tsy misy tsipika)
label string Ny mari-tsoratra nomena rehefa noforonina ilay sary
server_hostname string Ny anaran'ny mpizara izay nandraisana ilay sary mivantana, na tsy misy raha tsy misy intsony ilay mpizara
ready boolean Marina rehefa vita ilay sary
deleting boolean Marina raha mbola eo am-panafoanana
created_at datetime Fotoana namoronana (ISO 8601, UTC)
size_gb number Haben'ny fafàna (gigabyte)
ALAO /api/v1/snapshots/{uuid}/

Maka sary

Mamaly zavatra iray misy sary iray miaraka amin'ireo sehatr'asa etsy ambony. Ampiasao io mba hametrahana ny fitsapana fa efa vonona aorian'ny famoronana sary iray.

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

Hamorona sary mifono

Mametraka an-tsarin'ny mpizara iray amin'ny filaharana ary mamerina ny uuid'ilay sary vaovao. Aseho avy hatrany amin'ny famaritana ny ready ho diso ilay sary.

Mila alalana: servers:snapshot

Fangatahana masontsivana momba ny vatana

Mpizahaky ny macro Karazana ilaina Fanoritsoritana
action string ENY Tsy maintsy sary mivantana
snapshot_label string ENY Marika iray ahafahan'ny mpampiasa mahatakatra ilay sary
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"])

Ohatra amin'ny Valiny

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

Kaody momba ny satan'ny valiny

200 Voasoratra anatin'ny filaharana ilay asa
400 Tsy misy action na snapshot_label, na tsy mbola napetraka ny 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
Fafao /api/v1/snapshots/{uuid}/

Fafao ilay sary

Mametraka ilay sary ho fafàna mandrakizay. Tsy misy fafàna raha tsy efa maty izy.

Mila alalana: snapshots:delete

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

Kaody momba ny satan'ny valiny

202 No ekena: napetraka ho anatin'ny filaharana ilay fangatahana
404 Tsy hita, na an'ny kaonty hafa izy io

Fanamarihana