Rezerves kopiju API

Uzskaitīt visas rezerves kopijas

Atgriež visu jūsu serveru rezerves kopijas, jaunākā pirmā, 25 vienā lapā. Nav serveru filtra: izmantojiet serveri_hostname, lai grupētu tos.

Nepieciešamā atļauja: backups:list

Vaicājuma parametri

Pieprasījuma piemērs

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

Atbildes piemērs

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

Atbildes lauki

Atbildes statusa kodi

Iegūst rezerves

Atgriež vienu rezerves objektu ar laukiem virs.

curl -X GET "https://admin.vps.org/api/v1/backups/5512/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Izveidot rezerves kopu

Ielādē ierīkotā servera rezerves kopiju. Nav nepieciešams pieprasīto iestāžu saraksts. Kopsavilkums parādās sarakstā, kad tas ir pabeigts, kas var aizņemt vairākas minūtes atkarībā no diska lietošanas.

Nepieciešamā atļauja: 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())

Atbildes piemērs

{
  "message": "Backup queued successfully"
}

Atbildes statusa kodi

Atjaunot serveri no rezerves

Aptur serveri, no kura tika izņemta rezerves kopija, pārraksta tā disku ar rezerves kopiju un atkal sāk to. Nav nepieciešams pieprasīt iestādi. Servera statuss ir rindā, kamēr tiek atjaunota.

Nepieciešamā atļauja: 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"
}

Atbildes statusa kodi

Piezīmes

• Rezerves rezerves beidzas automātiski. Lasīt dzēšanu_datums vai dienas_turpinot nevis pieņemot saglabāšanas periodu.
• API nevar dzēst rezerves kopiju.
• Snapshots ir atsevišķs resurss ar savu galapunktu un nav uzskaitīti šeit. Momentuzņēmumu API