VPS.org API

REST API փաստաթղթավորում

Պահուստավորման API

Ցույց տալ սերվերի պահպանված տարբերակների ցանկը, սկսել նոր պահպանված տարբերակ և վերականգնել սերվերը մեկից։

Վերջնակետեր 4
Հիմնական ուղի /api/v1/backups
ՍՏԱՆԱԼ /api/v1/backups/

Ցանկագրեք բոլոր պահուստային պատճենները

Վերադարձնում է բոլոր սերվերների պահպանված տարբերակները, սկզբում նորագույնը, 25 էջը մեկ։ Չկա սերվերի ֆիլտր: օգտագործեք server_hostname դրանք խմբավորելու համար։

Պահանջվող թույլտվություն: 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 Creation time (ISO 8601, UTC)

Պատասխանի կարգավիճակի կոդեր

200 Սխալ է ՝ պահպանման ցուցակը չկար
403 Հաշվառված կամ օրինական API token-ը բացակայում է, կամ token-ը չունի անհրաժեշտ թույլտվություն
ՍՏԱՆԱԼ /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 Չգտնվեց կամ պատկանում է այլ հաշվին

Ծանոթագրություններ