VPS.org API

REST API ကိုစာရွက်စာတမ်းများ

အရန်ကူးယူခြင်း API

သင့်ရဲ့ server ကို backups စာရင်း, အသစ် backup ကိုစတင်နှင့်တစ်ဦးက server ကို restore ။

အဆုံးမှတ်များ 4
အခြေခံလမ်းကြောင်း /api/v1/backups
ရယူပါ /api/v1/backups/

အရန်ကူးယူမှုအားလုံးကို စာရင်းပြုစုပါ

အားလုံးသင့်ရဲ့ servers များ၏ backup ကိုပြန်လာ, အသစ်ဆုံးပထမဦးဆုံး, 25 စာမျက်နှာတစ်မျက်နှာလျှင်။ server filter ကိုမရှိပါ: သူတို့ကိုစုစည်းရန် server_hostname ကိုအသုံးပြုပါ။

ခွင့်ပြုချက်လိုအပ်သည်: backups:list

မေးမြန်းချက် ကန့်သတ်ချက်များ

သတ်မှတ်ချက် အမျိုးအစား လိုအပ်သည် ဖော်ပြချက်
page integer ဟုတ်ကဲ့ စာမျက်နှာနံပါတ်၊ ၁ မှစတင်သည်

နမူနာတောင်းဆိုချက်

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 Delete_Date အထိ ကျန်ရှိသောနေ့ပေါင်း
created_at datetime ဖန်တီးချိန် (ISO 8601, UTC)

တုံ့ပြန်မှု အခြေအနေ ကုဒ်များ

200 バックアップစာရင်းကို အောင်မြင်စွာ ရှာဖွေနိုင်သည်
403 API token မပါဘဲ သို့မဟုတ် မမှန်ကန်ပါ၊ သို့မဟုတ် token သည်လိုအပ်သောခွင့်ပြုချက်မရှိပါ
ရယူပါ /api/v1/backups/{id}/

バックアップယူပါ

အပေါ်က Fields တွေနဲ့ backup object တစ်ခုပြန်လာ

curl -X GET "https://admin.vps.org/api/v1/backups/5512/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
ပို့စ် /api/v1/servers/{uuid}/backup/

バックအမ်ပရိုဖိုင်ကိုဖန်တီးပါ

ဖြန့်ချိထားသော ဆာဗာ၏ backup ကို တန်းစီသည်။ တောင်းဆိုမှုကိုယ်ခန္ဓာမရှိပါ။ 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/

ဆာဗာကို バックアップမှ ပြန်တည်ဆောက်ပါ

သိမ်းဆည်းမှုမှယူခဲ့သည်က server ကိုရပ်တန့်, သိမ်းဆည်းမှုနှင့်အတူ၎င်း၏ဒစ်ကက်ကို overwrites နှင့်ထပ်မံစတင်. အဘယ်သူမျှမတောင်းဆိုချက်ကိုယ်ခန္ဓာလိုအပ်သည်. ပြန်လည်ထူထောင်ရေး runs စဉ် server အခြေအနေကတန်းစီနေသည်.

ခွင့်ပြုချက်လိုအပ်သည်: 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"
}
သတိပေးချက်: ဆာဗာသို့ရေးသားထားသောအရာအားလုံးကို backup လုပ်ပြီးသည်နှင့်ဆုံးရှုံးသွားသည်၊ ပြန်တည်ဆောက်ခြင်းကိုမပြုလုပ်နိုင်ပါ။

တုံ့ပြန်မှု အခြေအနေ ကုဒ်များ

200 လုပ်ဆောင်ချက်ကို တန်းစီထားသည်
400 ဆာဗာကို တပ်ဆင်ထားခြင်းမရှိပါ
404 မတွေ့ရှိပါ၊ သို့မဟုတ် အခြားအကောင့်တစ်ခုနှင့် သက်ဆိုင်သည်

မှတ်စုများ