بیک اپ API

تمام بیک اپ کی فہرست بنائیں

اپنے سرورز پر تمام بیک اپس کی فہرست بازیافت کریں۔

سوال کے پیرامیٹرز

مثال کی درخواست

curl -X GET "https://admin.vps.org/api/v1/backups/?server_id=12345" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests

url = "https://admin.vps.org/api/v1/backups/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
params = {"server_id": 12345}

response = requests.get(url, headers=headers, params=params)
print(response.json())

const response = await fetch('https://admin.vps.org/api/v1/backups/?server_id=12345', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const backups = await response.json();
console.log(backups);

مثال کا جواب

{
  "count": 3,
  "results": [
    {
      "id": 501,
      "server": {
        "id": 12345,
        "name": "web-server-01"
      },
      "backup_type": "automatic",
      "status": "completed",
      "size_mb": 4523,
      "created_at": "2025-01-16T03:00:00Z",
      "expires_at": "2025-02-16T03:00:00Z",
      "description": "Automatic daily backup"
    },
    {
      "id": 499,
      "server": {
        "id": 12345,
        "name": "web-server-01"
      },
      "backup_type": "manual",
      "status": "completed",
      "size_mb": 4456,
      "created_at": "2025-01-14T10:30:00Z",
      "expires_at": null,
      "description": "Pre-update backup"
    },
    {
      "id": 495,
      "server": {
        "id": 12345,
        "name": "web-server-01"
      },
      "backup_type": "automatic",
      "status": "completed",
      "size_mb": 4389,
      "created_at": "2025-01-15T03:00:00Z",
      "expires_at": "2025-02-15T03:00:00Z",
      "description": "Automatic daily backup"
    }
  ]
}

رسپانس اسٹیٹس کوڈز

دستی بیک اپ بنائیں

سرور کا دستی بیک اپ بنائیں۔ دستی بیک اپ خود بخود ختم نہیں ہوتے ہیں۔

جسمانی پیرامیٹرز کی درخواست کریں۔

مثال کی درخواست

curl -X POST "https://admin.vps.org/api/v1/backups/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "server_id": 12345,
    "description": "Pre-deployment backup"
  }'

import requests

url = "https://admin.vps.org/api/v1/backups/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "server_id": 12345,
    "description": "Pre-deployment backup"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

const response = await fetch('https://admin.vps.org/api/v1/backups/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    server_id: 12345,
    description: 'Pre-deployment backup'
  })
});

const backup = await response.json();
console.log(backup);

$data = [
    'server_id' => 12345,
    'description' => 'Pre-deployment backup'
];

$ch = curl_init('https://admin.vps.org/api/v1/backups/');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_TOKEN',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$backup = json_decode($response, true);
curl_close($ch);

مثال کا جواب

{
  "id": 502,
  "server": {
    "id": 12345,
    "name": "web-server-01"
  },
  "backup_type": "manual",
  "status": "in_progress",
  "size_mb": null,
  "created_at": "2025-01-16T15:45:00Z",
  "expires_at": null,
  "description": "Pre-deployment backup",
  "message": "Backup is being created. This may take several minutes depending on server size."
}

رسپانس اسٹیٹس کوڈز

بیک اپ کو حذف کریں۔

بیک اپ کو مستقل طور پر حذف کریں۔ اس کارروائی کو کالعدم نہیں کیا جا سکتا۔

راستے کے پیرامیٹرز

مثال کی درخواست

curl -X DELETE "https://admin.vps.org/api/v1/backups/501/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests

backup_id = 501
url = f"https://admin.vps.org/api/v1/backups/{backup_id}/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.delete(url, headers=headers)
print(response.status_code)

const backupId = 501;
const response = await fetch(`https://admin.vps.org/api/v1/backups/${backupId}/`, {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

console.log(response.status);

رسپانس اسٹیٹس کوڈز

بیک اپس سے بحال ہو رہا ہے۔

بیک اپ سے سرور کو بحال کرنے کے لیے، سرورز API ریسٹور اینڈ پوائنٹ کا استعمال کریں:

POST /api/v1/servers/{server_id}/restore/
{
  "backup_id": 501
}

سرور کی بحالی کے بارے میں تفصیلی معلومات کے لیے، دیکھیں سرورز API دستاویزات.

بیک اپ بہترین پریکٹسز

• باقاعدہ بیک اپ: اہم سرورز کے لیے خودکار بیک اپ کو فعال کریں۔
• پری اپ ڈیٹ بیک اپس: اہم اپ ڈیٹس یا تبدیلیوں سے پہلے ہمیشہ دستی بیک اپ بنائیں
• ٹیسٹ کی بحالی: بیک اپ کی سالمیت کی تصدیق کے لیے وقتاً فوقتاً بیک اپ بحالی کی جانچ کریں۔
• بیک اپ برقرار رکھنا: اپنی ضروریات کے مطابق کم از کم 7-30 دنوں تک بیک اپ رکھیں
• آف سائٹ کاپیاں: آف سائٹ اسٹوریج کے لیے اہم بیک اپ ڈاؤن لوڈ کرنے پر غور کریں۔