Uluhlu lweendawo zokugcina ezikhuselekileyo zeseva yakho, qala indawo yokugcina ekhuselekileyo entsha kwaye ubuyisele iseva ukusuka kwinye.
Ibuyisela ukhuseleko lwazo zonke iinkonzo zakho, ezitsha kuqala, 25 kwiphepha ngalinye. Akukho sihluzi somncedisi: sebenzisa server_ hostname ukuzidibanisa.
Iimvume ezifunekayo: backups:list
| Iparamitha | Uhlobo | Kufuneka | Inkcazelo |
|---|---|---|---|
page |
integer | Akukho nanye | Inani lephepha, liqala ku-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"
}
]
}
| Iindawo | Uhlobo | Inkcazelo |
|---|---|---|
id |
integer | Isichazi-magama sovimba weefayili, esisetyenziswa yi-get ne-restore endpoints |
server_hostname |
string | Igama lomququzeleli weseva ekufuneka igcinwe kuyo |
name |
string | Igama lefayili yovimba we-Backup |
size_gb |
number | Ubungakanani obucinezelweyo kwi-gigabytes |
deletion_date |
datetime | Xa ugcino bugcinwa ngokuzenzekelayo |
days_remaining |
integer | Iintsuku ezipheleleyo eziseleyo de kube ngu-deletion_date |
created_at |
datetime | Ixesha lokuvelisa (ISO 8601, UTC) |
| 200 | Uluhlu lovimba weefayili olubuyiselwe ngokuphumelelayo |
| 403 | I-API token elahlekile okanye engasebenziyo, okanye i-token ayinazimvumelwano ezifunekayo |
Ibuyisela enye injongo yokhuseleko enendawo engaphezulu.
curl -X GET "https://admin.vps.org/api/v1/backups/5512/" \
-H "Authorization: Bearer YOUR_API_TOKEN"
Ifoloza ugcino bucala lomncedisi onikezelweyo. Akukho mzimba wesicelo ofunekayo. Ugcino bucala luvela kuluhlu xa lugqityiwe, olunokuthatha imizuzu emininzi ngokuxhomekeka kusebenziso lwe diski.
Iimvume ezifunekayo: 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 | Intshukumo ifolokhwe |
| 400 | Umncedisi akasebenzisi i-%s |
| 402 | Akukho ndlela yohlawula kwifayili, okanye iinfaktura ezingahlawulwanga |
| 404 | Ayifumanekanga, okanye imalunga ne-akhawunti enye |
Imisa umncedisi othathwe kuwo ugcino-bucala, ibhale ngaphezulu idiski yayo ngokhuseleko kwaye iqale kwakhona. Akukho mzimba wesicelo ofunekayo. Iimeko zomncedisi zifoloxa ngelixa ubuyiselo luqhuba.
Iimvume ezifunekayo: 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 | Intshukumo ifolokhwe |
| 400 | Umncedisi akasebenzisi i-%s |
| 404 | Ayifumanekanga, okanye imalunga ne-akhawunti enye |