VPS.org API

REST API sənədləşdirilməsi

Yedəkləmə API-si

Verici zəmanət nüsxələrini göstər, yeni zəmanət nüsxəsini başlat və vericini birindən bərpa et.

Son Nöqtələr 4
Əsas Yol /api/v1/backups
AL /api/v1/backups/

Bütün Yedəkləmələri Siyahıya Alın

Bütün vericilərinizin zəmanət nüsxələrini geri qaytarır, ən yenisi əvvəlcə, səhifə başına 25. Verici filtri yoxdur: onları qruplaşdırmaq üçün server_hostname istifadə et.

İcazə tələb olunur: backups:list

Sorğu Parametrləri

Parametrlər Növü Tələb olunur İzahat
page integer _Yox Səhifə nömrəsi, 1-dən başlayır

Nümunə Sorğu

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

Nümunə Cavab

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

Cavab Sahələri

Sahə Növü İzahat
id integer Zəng et və bərpa et son nöqtələri tərəfindən istifadə edilən zəng identifikatoru
server_hostname string Zəng zənginə alınan vericinin qovşaq adı
name string Arxiv fayl adı
size_gb number Sıxışdırılmış böyüklük (giqabayt)
deletion_date datetime Zəng mərkəzi avtomatik olaraq silinəcəkdir
days_remaining integer silmə_tarixinə qədər qalan bütün günlər
created_at datetime Yaradılma vaxtı (ISO 8601, UTC)

Cavab Status Kodları

200 Zəng siyahısı müvəffəqiyyətlə alındı
403 API tokeni yoxdu ya da səhvdir, ya da tokenin lazımi icazəsi yoxdur
AL /api/v1/backups/{id}/

Zafer

Üstdəki sahələr ilə bir zəngçi cismi geri qaytarır.

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

Create a Backup

İcra edilmiş vericinin zəmanət nüsxəsini növbəyə qoyur. İstəyilmə bədəni lazım deyil. Disk istifadəsinə bağlı olaraq bir neçə dəqiqə çəkən zəmanət nüsxəsi bitdikdən sonra siyahıda görünəcəkdir.

İcazə tələb olunur: 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())

Nümunə Cavab

{
  "message": "Backup queued successfully"
}

Cavab Status Kodları

200 Əməliyyat qrupuna daxil edildi
400 Verici hələ işə salınıb
402 Faylda ödəniş üsulu yoxdur, ya da ödənilməyən faturalar var
404 Tapılmadı ya da başqa hesaba aiddir
POST /api/v1/backups/{id}/restore/

Zəng mərkəzi

Əlavə yaddaş alınan vericini dayandırır, diskin üzərindən əlavə yaddaşla əvəz edir və yenidən başladır. İstifadəçi istəyi lazım deyil. Əlavə yaddaş bərpa edildikdə vericinin vəziyyəti sıradadır.

İcazə tələb olunur: 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"
}
Xəbərdarlıq: Zapaqa alınandan sonra vericiyə yazılmış hər şey itiriləcəkdir. Bir bərpa geri alına bilməz.

Cavab Status Kodları

200 Əməliyyat qrupuna daxil edildi
400 Verici hələ işə salınıb
404 Tapılmadı ya da başqa hesaba aiddir

Qeydlər