Mampiseho ny lisitry ny tahirin-kevitrao momba ny mpizara, manomboka tahirin-kevitra vaovao ary mamerina mpizara iray avy amin'ny iray.
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
| Mpizahaky ny macro | Karazana | ilaina | Fanoritsoritana |
|---|---|---|---|
page |
integer | Tsy misy | Isan'ny pejy, manomboka amin'ny 1 |
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);
{
"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"
}
]
}
| 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) |
| 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 |
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"
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 -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())
{
"message": "Backup queued successfully"
}
| 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 |
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"
}
| 200 | Voasoratra anatin'ny filaharana ilay asa |
| 400 | Tsy mbola napetraka ilay mpizara |
| 404 | Tsy hita, na an'ny kaonty hafa izy io |