VPS.org API

REST API დოკუმენტაცია

სარეზერვო ასლების API

სერვერის სარეზერვო ასლების ჩამონათვალი, ახალი სარეზერვო ასლის დაწყება და სერვერის ერთიდან აღდგენა.

საბოლოო წერტილები 4
ბაზისური გზა /api/v1/backups
მიიღეთ /api/v1/backups/

ყველა სარეზერვო ასლის სია

ყველა სერვერის სარეზერვო ასლის დაბრუნება, ახალი ჯერ, 25 გვერდზე. სერვერის ფილტრი არ არსებობს: გამოიყენეთ სერვერის_ ჰოსტის სახელი მათი ჯგუფებისთვის.

საჭიროა უფლება: backups:list

მოთხოვნის პარამეტრები

პარამეტრები ტიპი სავალდებულო აღწერა
page integer ნვ, ნვ ჟყმ. გვერდის ნომერი, 1- დან დაწყებული

მაგალითის მოთხოვნა

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

მაგალითის პასუხი

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

პასუხის ველები

ველი ტიპი აღწერა
id integer სარეზერვო ასლის იდენტიფიკატორი, რომელიც გამოიყენება მიღებისა და აღდგენის დასასრული წერტილების მიერ
server_hostname string სერვერის ჰოსტის სახელი, საიდანაც სარეზერვო ასლი მიიღეს
name string სარეზერვო ასლის არქივის ფაილის სახელი
size_gb number შეკუმშული ზომა გიგაბაიტებში
deletion_date datetime სარეზერვო ასლის ავტომატური წაშლის თარიღი
days_remaining integer წაშლის თარიღამდე მთელი დღეები დარჩა
created_at datetime შექმნის დრო (ISO 8601, UTC)

პასუხის სტატუსის კოდები

200 სარეზერვო ასლის სია წარმატებით ამოღებულია
403 API ტოკენი არ არის ან არასწორია, ან ტოკენს არ აქვს საჭირო უფლება
მიიღეთ /api/v1/backups/{id}/

სარეზერვო ასლის მიღება

უკან ბრუნავს ერთ სარეზერვო ობიექტს ზემოთ მოცემული ველით.

curl -X GET "https://admin.vps.org/api/v1/backups/5512/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
წერილის გაგზავნა /api/v1/servers/{uuid}/backup/

სარეზერვო ასლის შექმნა

სერვერის სარეზერვო ასლის შექმნა. მოთხოვნის სხეული არ არის საჭირო. სარეზერვო ასლი გამოჩნდება სიაში მისი დასრულების შემდეგ, რაც შეიძლება რამდენიმე წუთი დასჭირდეს, დისკზე ადგილის გამოყენების მიხედვით.

საჭიროა უფლება: 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())

მაგალითის პასუხი

{
  "message": "Backup queued successfully"
}

პასუხის სტატუსის კოდები

200 მოქმედება რიგის მიღმა იყო
400 სერვერი ჯერ არ არის განთავსებული
402 ფაილში გადახდის მეთოდი არ არის, ან გადახდილი ანგარიშები არ არის
404 ვერ მოიძებნა, ან სხვა ანგარიშს ეკუთვნის
წერილის გაგზავნა /api/v1/backups/{id}/restore/

სერვერის სარეზერვო ასლის აღდგენა

შეწყვეტს სერვერს, საიდანაც სარეზერვო ასლი მიიღეს, გადაამოწმებს დისკს სარეზერვო ასლით და ისევ იწყებს. მოთხოვნის სხეული არ არის საჭირო. სერვერის სტატუსი არის რიგი, როდესაც აღდგენა მიმდინარეობს.

საჭიროა უფლება: 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"
}
გაფრთხილება: ყველა, რაც სერვერზე დაიწერა სარეზერვო ასლის მიღების შემდეგ, დაკარგულია. აღდგენა ვერ განხორციელდება უკან.

პასუხის სტატუსის კოდები

200 მოქმედება რიგის მიღმა იყო
400 სერვერი ჯერ არ არის განთავსებული
404 ვერ მოიძებნა, ან სხვა ანგარიშს ეკუთვნის

შენიშვნები