Сақтық көшірмелер API

Барлық сақтық көшірмелердің тізімін жасаңыз

Барлық серверлеріңіздің сақтық көшірмелерін қайтарады, жаңасы алдымен, бір бетке 25. Сервер сүзгісі жоқ: оларды топтастыру үшін 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"
    }
  ]
}

Жауап өрістері

Жауап күйінің кодтары

Сақтық көшірмені алу

Returns one backup object with the fields above.

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

Жауап күйінің кодтары

Серверді сақтық көшірмеден қалпына келтіру

Сақтық көшірме алынған серверді тоқтату, дискіні сақтық көшірмемен үстінен жазу, сосын қайта жегу. Сұраныстың мазмұны керек емес. Сақтық көшірме жасағанда сервердің күйі кезек.

Рұқсат керек: 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"
}

Жауап күйінің кодтары

Жазбалар

• Сақтық көшірме автоматты түрде мерзімінен бұрын жойылады. Сақтау мерзімі дегеннің орнына deletion_date не days_remaining дегендерді оқыңыз.
• API сақтық көшірмені өшіре алмайды.
• Снимкалар өзінің аяқтау нүктесімен бөлек ресурс болып табылады, сондықтан олар тізімде көрсетілмейді. Суреттер API интерфейсі