Zaxira nusxalari APIsi

Barcha zaxira nusxalarini ro'yxatlash

Барча серверларингизнинг захира нусхаларини қайтаради, энг янгиси аввал, саҳифада 25. Сервер филтри йўқ: уларни гуруҳлаш учун server_hostname'дан фойдаланинг.

Ҳужжат талаб этилади: backups:list

So'rov parametrlari

Namunaviy so'rov

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

Javob namunasi

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

Javob maydonlari

Javob holati kodlari

Захира нусхасини олиш

Юқоридаги майдонлар билан бирта заҳира нусхасини қайтаради.

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

Javob namunasi

{
  "message": "Backup queued successfully"
}

Javob holati kodlari

Серверни заҳира нусхасидан тиклаш

Захира нусхаси олинган серверни тўхтатади, унинг дискини заҳира нусхаси билан қайта ёзади ва уни қайта ишга туширади. Талабнинг ўзига эҳтиёж йўқ. Сервер ҳолати қайта тиклаш амалга оширилаётганда навбатда турибди.

Ҳужжат талаб этилади: 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"
}

Javob holati kodlari

Ёдлаш

• Захира нусхалари автоматик тарзда тугайди. сақлаш муддатини ҳисоблаш ўрнига delete_date ёки days_remaining ни ўқинг.
• API заҳира нусхасини ўчириб юбора олмайди.
• Снимкалар ўзларининг охирига эга алоҳида ресурсдир ва бу ерда рўйхатга олинмайди. Snapshots API'si