API پشتیبان‌گیری

فهرست کردن تمام نسخه‌های پشتیبان

بازگرداندن پشتیبانهای همۀ کارسازهای شما ، اول جدیدترین ، ۲۵ در هر صفحه. هیچ پالایه کارساز وجود ندارد: از server_ hostname برای گروه‌بندی آنها استفاده کنید.

مجوز مورد نیاز: backups:list

پارامترهای پرس و جو

درخواست نمونه

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

پاسخ نمونه

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

فیلدهای پاسخ

کدهای وضعیت پاسخ

گرفتن پشتیبان

یک شیء پشتیبان با فیلدهای بالا را برمی‌گرداند.

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

ایجاد پشتیبان

صف پشتیبان‌گیری از کارساز پراکنده را در صف قرار می‌دهد. بدنۀ درخواست نیازی نیست. پشتیبان‌گیری هنگامی که تمام شد ، در فهرست ظاهر می‌شود ، که ممکن است چند دقیقه بستگی به استفاده از دیسک طول بکشد.

مجوز مورد نیاز: 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())

پاسخ نمونه

{
  "message": "Backup queued successfully"
}

کدهای وضعیت پاسخ

زمان‌بندی پشتیبان‌گیری‌های خودکار

پشتیبان‌گیری خودکار روزانه یا هفتگی را روشن یا خاموش می‌کند ، تنظیم مشابه تب پشتیبان‌گیری در قاب کنترل. GET زمان‌بندی جاری را برمی‌گرداند. PATCH) یا PUT (هر یک از حوزه‌های زیر را تغییر می‌دهد. روشن کردن پشتیبان‌گیری در صف ، پشتیبان‌گیری اول را بلافاصله انجام می‌دهد. هر پشتیبان‌گیری برای ۷ روز نگهداری می‌شود.

مجوز مورد نیاز: servers:backup

curl -X PATCH "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/backup-settings/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"enabled": true, "plan": "daily", "window": "8-12"}'

import requests

server_uuid = "8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b"
url = f"https://admin.vps.org/api/v1/servers/{server_uuid}/backup-settings/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.patch(url, headers=headers, json={"enabled": True, "plan": "daily", "window": "8-12"})
print(response.json())

پاسخ نمونه

{
  "enabled": true,
  "plan": "daily",
  "window": "8-12",
  "retention_days": 7,
  "price_percent_of_plan": 30,
  "last_backup_at": "2026-10-28T23:33:50Z",
  "backups_kept": 1
}

کدهای وضعیت پاسخ

بازگرداندن کارساز از یک پشتیبان

کارساز را که از آن پشتیبان گرفته شده متوقف می‌کند ، دیسک آن را با پشتیبان جای‌نوشت می‌کند و دوباره شروع می‌کند. بدنۀ درخواست نیازی نیست. وضعیت کارساز صف است ، در حالی که بازگردانی در حال اجراست.

مجوز مورد نیاز: 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"
}

کدهای وضعیت پاسخ

یادداشتها

• پشتیبان‌ها به‌طور خودکار به پایان می‌رسند. تاریخ حذف یا روزهای باقی‌مانده را به جای فرض یک دوره نگهداری بخوانید.
• API نمی‌تواند یک پشتیبان را حذف کند.
• گراف‌های تصادفی گراف‌هایی هستند که در آن‌ها رأس‌ها و انتهای آن‌ها در یک خط قرار دارند و هیچ‌کدام از آن‌ها در یک خط قرار ندارند. API اسنپ‌شات‌ها