API Cadangan

Daftar Semua Cadangan

Mengembalikan backup dari semua server Anda, pertama, 25 per halaman. Tidak ada filter server: gunakan server_hostname untuk mengelompokkan mereka.

Perlu izin: backups:list

Parameter Kueri

Contoh Permintaan

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

Contoh Jawaban

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

Kolom Respons

Kode Status Respons

Dapatkan Bantuan

Mengembalikan satu objek cadangan dengan ruas di atas.

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

Buat Backup

Mengantre cadangan server yang dikerahkan. Tidak ada permintaan tubuh yang diperlukan. Backup muncul dalam daftar setelah selesai, yang dapat memakan waktu beberapa menit tergantung pada penggunaan disk.

Perlu izin: 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())

Contoh Jawaban

{
  "message": "Backup queued successfully"
}

Kode Status Respons

Mengembalikan Server dari Backup

Menghentikan server yang backup diambil dari, menimpa disknya dengan backup dan memulainya lagi. Tidak ada badan permintaan yang diperlukan. Status server antrian saat restore runs.

Perlu izin: 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"
}

Kode Status Respons

Catatan

• Backup kadaluarsa secara otomatis. Baca penghapusan_date atau hari-hari_kembali daripada mengasumsikan periode retensi.
• API tak bisa menghapus suatu backup.
• Snapshot adalah sumber daya terpisah dengan titik akhir mereka sendiri dan tidak terdaftar di sini. API Cuplikan