Yedeklemeler API'si

Tüm Yedeklemeleri Listele

Tüm sunucularınızın yedeklerini, en yenisi önce, sayfa başına 25 olarak geri verir. Sunucu filtresi yoktur: gruplamak için server_hostname kullanın.

İzin gerekiyor: backups:list

Sorgu Parametreleri

Örnek Talep

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

Örnek Yanıt

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

Yanıt Alanları

Yanıt Durum Kodları

Yedekleme Yap

Yukarıdaki alanlarla bir yedekleme nesnesi geri döndürür.

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

Bir yedek oluştur

Kullanılmış bir sunucunun yedekleme kuyruğuna girer. İstek bedenine ihtiyaç yoktur. Yedekleme tamamlandığında listede görüntülenir, bu disk kullanımına bağlı olarak birkaç dakika sürebilir.

İzin gerekiyor: 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())

Örnek Yanıt

{
  "message": "Backup queued successfully"
}

Yanıt Durum Kodları

Bir sunucuyu yedekten geri yükle

Yedekleme alındığı sunucuyu durdurur, disk üzerindeki yedeklemeyi değiştirir ve yeniden başlatır. İstek bedeni gerekmez. Sunucu durumunun geri yükleme sırasında sıra halinde olması.

İzin gerekiyor: 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"
}

Yanıt Durum Kodları

Notlar

• Yedekleme otomatik olarak sona erer. Deletion_date veya days_remaining'i okuyun, bir saklanma süresi varsayın.
• API bir yedeklemeyi silmemektedir.
• Snapshot'lar kendi son noktalarıyla ayrı bir kaynaktır ve burada listelenmez. Anlık Görüntüler API'si