VPS.org API

PENDEKEZO LA MAFUTA

API ya Hifadhi Rudufu

Orodhesha mhudumu wako, anzisha mgongo mpya na kurudisha msaidizi kutoka kwa mmoja.

Sehemu za Mwisho 4
Njia ya Msingi /api/v1/backups
PATA /api/v1/backups/

Orodhesha Hifadhi Nakala Zote

Arudi nyuma ya vipengele vyenu vyote, kwanza kabisa, 25 kwa kila ukurasa. Hakuna kichujio cha wahifadhi: tumia ser_hostname jina la kuweka.

Ruhusa ya Kuruhusiwa: backups:list

Vigezo vya Hoja

Penseli Aina Inahitajika Maelezo
page integer Hapana Page number, starting at 1

Ombi la Mfano

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

Jibu la Mfano

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

Sehemu za Majibu

Field Aina Maelezo
id integer Mtambuaji wa nyuma, atumiaye na kuweka alama za mwisho na kuzirudisha
server_hostname string Jina la kiongozi huyo liliondolewa
name string Faili ya faili
size_gb number Ukubwa uliokandamizwa katika mchezo wa gigablings
deletion_date datetime Litakapo tukia hilo Tukio
days_remaining integer Siku nzima zilibaki mpaka depusion_date
created_at datetime Creation time (ISO 8601, UTC)

Misimbo ya Hali ya Majibu

200 Orodha ya mambo ya zamani yaliyofanikiwa
403 Ishara hiyo ikikosekana au yenye kasoro, au ile ishara haina ruhusa inayohitajiwa
PATA /api/v1/backups/{id}/

Tafuta Msaada

Arudi nyuma kitu kimoja chenye mgongo na mashamba yaliyo juu.

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

Andaa Mgongo

Queues a backup of a deployed server. No request body is needed. The backup appears in the list once it has finished, which can take several minutes depending on disk usage.

Ruhusa ya Kuruhusiwa: 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())

Jibu la Mfano

{
  "message": "Backup queued successfully"
}

Misimbo ya Hali ya Majibu

200 Hatua hiyo ilipangwa kwa mfuatano
400 Mtumishi bado hajatumiwa
402 Hakuna njia ya kulipa kwenye faili, au kwenye ovari zisizolipwa
404 Si wapatikanao, wala si wa Akaunti jingine
PENDEKEZO /api/v1/backups/{id}/restore/

Mrudishe Mtumikaji Kutoka Kwenye Mgongo

Aacha kubeji ya nyuma ichukuliwe, pindua kichwa chake kwa nyuma na uanzishe tena.

Ruhusa ya Kuruhusiwa: 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"
}
Onyo: Kila kitu kilichoandikiwa mtumishi baada ya kutwaliwa kinapotea.

Misimbo ya Hali ya Majibu

200 Hatua hiyo ilipangwa kwa mfuatano
400 Mtumishi bado hajatumiwa
404 Si wapatikanao, wala si wa Akaunti jingine

Marejeo