API sao lưu

Liệt kê tất cả các bản sao lưu

Truy xuất danh sách tất cả các bản sao lưu trên các máy chủ của bạn.

Tham số truy vấn

Ví dụ về yêu cầu

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

Ví dụ về câu trả lời

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

Mã trạng thái phản hồi

Tạo bản sao lưu thủ công

Tạo bản sao lưu thủ công cho máy chủ. Các bản sao lưu thủ công không tự động hết hạn.

Các tham số thân yêu cầu

Ví dụ về yêu cầu

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

Ví dụ về câu trả lời

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

Mã trạng thái phản hồi

Xóa bản sao lưu

Xóa vĩnh viễn bản sao lưu. Thao tác này không thể hoàn tác.

Tham số đường dẫn

Ví dụ về yêu cầu

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

Mã trạng thái phản hồi

Khôi phục từ bản sao lưu

Để khôi phục máy chủ từ bản sao lưu, hãy sử dụng điểm cuối khôi phục API Máy chủ :

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

Để biết thông tin chi tiết về việc khôi phục máy chủ, vui lòng xem phần [liên kết đến tài liệu hướng dẫn]. Tài liệu API máy chủ.

Thực tiễn tốt nhất về sao lưu

• Sao lưu thường xuyên: Bật tính năng sao lưu tự động cho các máy chủ quan trọng.
• Sao lưu trước khi cập nhật: Luôn tạo bản sao lưu thủ công trước khi thực hiện các bản cập nhật hoặc thay đổi lớn.
• Kiểm tra khôi phục: Thường xuyên kiểm tra quá trình khôi phục bản sao lưu để xác minh tính toàn vẹn của bản sao lưu.
• Thời gian lưu trữ bản sao lưu: Hãy sao lưu dữ liệu trong ít nhất 7-30 ngày tùy thuộc vào nhu cầu của bạn.
• Bản sao lưu ngoài địa điểm: Hãy cân nhắc tải xuống các bản sao lưu quan trọng để lưu trữ ở nơi khác.