VPS.org API

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

Snapshots API

ဆာဗာ၏ labelled snapshots ကိုယူ, သူတို့ကိုစာရင်းနှင့်သင်လိုအပ်ချက်မရှိတော့သောသူတို့ကိုဖျက်ပစ်။

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

Snapshot အားလုံးကို စာရင်းပြုစုပါ

သင့်အကောင့်ထဲမှာ snapshots ပြန်လာ, အသစ်ဆုံးပထမဦးဆုံး, 25 စာမျက်နှာတစ်ဦးလျှင်။

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

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

cURL
Python
JavaScript
curl -X GET "https://admin.vps.org/api/v1/snapshots/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
import requests

url = "https://admin.vps.org/api/v1/snapshots/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.get(url, headers=headers)
for snapshot in response.json()["results"]:
    print(snapshot["uuid"], snapshot["label"], snapshot["ready"])
const response = await fetch('https://admin.vps.org/api/v1/snapshots/', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
});

const data = await response.json();
console.log(data.results);

ဥပမာတုံ့ပြန်မှု

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "3f9a1c0e5b7d4e2f8a6c1b3d5e7f9a0b",
      "label": "before-upgrade",
      "server_hostname": "web-01",
      "ready": true,
      "deleting": false,
      "created_at": "2026-09-14T18:30:00.000000Z",
      "size_gb": 3.4
    }
  ]
}

တုံ့ပြန်မှု ကွက်လပ်များ

နယ်မြေ အမျိုးအစား ဖော်ပြချက်
uuid string Snapshot အသိအမှတ်ပြု (32 hexadecimal အက္ခရာများ, hyphens မရှိ)
label string ချက်ချင်းပုံကို ဖန်တီးတဲ့အခါ ပေးထားတဲ့ အမှတ်အသား
server_hostname string ချက်ချင်းပုံကို သိမ်းဆည်းတဲ့ ဆာဗာရဲ့ ဟိုတယ်အမည်၊ ဆာဗာမရှိတော့ရင် လုံးဝမရှိဘူး
ready boolean ဓာတ်ပုံရိုက်ယူမှုပြီးဆုံးပြီးမှမှန်ပါ
deleting boolean ဖျက်ပစ်ခြင်း လုပ်ဆောင်နေစဉ် true
created_at datetime ဖန်တီးချိန် (ISO 8601, UTC)
size_gb number ဖိသိပ်ထားသော အရွယ်အစားကို ဂီဂါဘိုက်များဖြင့်
ရယူပါ /api/v1/snapshots/{uuid}/

ဓာတ်ပုံတစ်ပုံရယူပါ

အပေါ်က နယ်ပယ်တွေနဲ့အတူ ဓာတ်ပုံတစ်ခုကို ပြန်ပေးတယ်။ ဓာတ်ပုံတစ်ခု ဖန်တီးပြီးတဲ့နောက် အဆင်သင့်ဖြစ်အောင် မေးမြန်းဖို့ သုံးပါ။

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

ဓာတ်ပုံတစ်ခုဖန်တီးပါ

ဖြန့်ချိထားတဲ့ ဆာဗာရဲ့ ဓာတ်ပုံတစ်ပုံကို တန်းစီပြီး အသစ်ဖြစ်တဲ့ ဓာတ်ပုံရဲ့ uuid ကို ပြန်ပေးတယ်။ ဓာတ်ပုံကို အဆင်သင့်ဖြစ်တဲ့ သတ်မှတ်ချက်နဲ့ ချက်ချင်း စာရင်းပြုစုထားတယ်။

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

ခန္ဓာကိုယ် ကန့်သတ်ချက်များ တောင်းဆိုပါ

သတ်မှတ်ချက် အမျိုးအစား လိုအပ်သည် ဖော်ပြချက်
action string ဟုတ်ကဲ့ ချက်ချင်းရိုက်ချက်ဖြစ်ရမည်
snapshot_label string ဟုတ်ကဲ့ ချက်ချင်းပုံကို အသိအမှတ်ပြုဖို့ အမှတ်အသား
cURL
Python
curl -X POST "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/snapshot/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "snapshot", "snapshot_label": "before-upgrade"}'
import requests

server_uuid = "8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b"
url = f"https://admin.vps.org/api/v1/servers/{server_uuid}/snapshot/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}
data = {"action": "snapshot", "snapshot_label": "before-upgrade"}

response = requests.post(url, headers=headers, json=data)
print(response.json()["snapshot_uuid"])

ဥပမာတုံ့ပြန်မှု

{
  "message": "Snapshot queued successfully",
  "snapshot_uuid": "3f9a1c0e5b7d4e2f8a6c1b3d5e7f9a0b"
}

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

200 လုပ်ဆောင်ချက်ကို တန်းစီထားသည်
400 action သို့မဟုတ် snapshot_label မပါ၊ သို့မဟုတ် ဆာဗာသည် တပ်ဆင်ထားခြင်းမရှိပါ
402 ဖိုင်ပေါ်တွင်ငွေပေးချေမှုနည်းလမ်းမရှိ၊ သို့မဟုတ်မပေးချေသောငွေစာရင်း
404 မတွေ့ရှိပါ၊ သို့မဟုတ် အခြားအကောင့်တစ်ခုနှင့် သက်ဆိုင်သည်
ဖျက်ရန် /api/v1/snapshots/{uuid}/

ချက်ချင်းပုံကို ဖျက်ပါ

သက်တမ်းကြာရှည်စွာ ဖျက်ပစ်ဖို့ ဓာတ်ပုံကို တန်းစီထားတယ်။ ဖျက်ပစ်တာဟာ ပျက်သွားတဲ့အထိ မှန်ပါတယ်။

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

curl -X DELETE "https://admin.vps.org/api/v1/snapshots/3f9a1c0e5b7d4e2f8a6c1b3d5e7f9a0b/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "message": "Snapshot deletion queued"
}

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

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

မှတ်စုများ