VPS.org API

ማስረጃ

ምትኬዎች ኤፒአይ

ሰርቨርዎ የቀረቡትን バックነቶች ዝርዝር፣ አዲስ バックነቶችን ይጀምሩ እና ሰርቨር ከአንድ ላይ ይመለሱ

የመጨረሻ ነጥቦች 4
የመሠረት መንገድ /api/v1/backups
አግኝ /api/v1/backups/

ሁሉንም ምትኬዎች ዘርዝር

የሁሉም ሰርቨሮችዎ バックアップን ይመልሳል፣ አዲስ መጀመሪያ፣ 25 በእያንዳንዱ ገጽ ላይ። ምንም ሰርቨር ማጣሪያ የለም: server_hostname ን በመጠቀም አሰባስቡዋቸው።

የፈቃድ መጠን: backups:list

የጥያቄ መለኪያዎች

መለኪያ አይነት ያስፈልጋል መግለጫ የለም
page integer አዎ Page number, starting at 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 የቀድሞው የፋይል ስም፦ (_P)
server_hostname string Hostname of the server the backup was taken from
name string የመዝገብ ቤት ስም፦ (_A)
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}/

ተጨማሪ ዕቃ

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"
ደብዳቤ /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 No payment method on file, or unpaid invoices
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 አልተገኘም ወይም ሌላ የግልጽነት መለያ ይዟል

ማስታወሻ