VPS.org API

ឯកសារ REST API

API រូបភាព​សង្ខេប

យក​រូបថត​ដែល​មាន​ស្លាក​របស់​ម៉ាស៊ីន​បម្រើ រាយ​ពួក​វា និង​លុប​ពួក​វា​ដែល​អ្នក​មិន​ត្រូវការ​ទៀត​ទេ ។

ចំណុចបញ្ចប់ 4
ផ្លូវមូលដ្ឋាន /api/v1/snapshots
ទទួលបាន /api/v1/snapshots/

រាយបញ្ជីរូបថតអេក្រង់ទាំងអស់

ត្រឡប់​រូបថត​ក្នុង​គណនី​របស់​អ្នក ថ្មី​បំផុត​ដំបូង ២៥ ក្នុង​មួយ​ទំព័រ ។

សិទ្ធិ​ដែល​ត្រូវការ: 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 ឧបករណ៍​កំណត់​អត្តសញ្ញាណ​រូបថត​ (៣២ តួអក្សរ​គោល​ដប់​ប្រាំមួយ គ្មាន​សញ្ញា​ក្បៀស)
label string ស្លាក​ដែល​បាន​ផ្ដល់​ពេល​រូបថត​ត្រូវ​បាន​បង្កើត
server_hostname string ឈ្មោះ​ម៉ាស៊ីន​បម្រើ​ដែល​បាន​ចាប់​យក​រូបថត​ពី ឬ​ទទេ បើ​ម៉ាស៊ីន​បម្រើ​នោះ​មិន​មាន​ទៀត​ទេ
ready boolean ពិត​នៅពេល​ដែល​រូបថត​បាន​បញ្ចប់
deleting boolean ពិត ខណៈ​ពេល​ដែល​ការ​លុប​កំពុង​ដំណើរការ
created_at datetime ពេលវេលា​បង្កើត (ISO 8601 ពេលវេលា​សហគមន៍​អន្តរជាតិ)
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/

បង្កើត​រូបថត​ Snapshot

ដាក់​ជា​ជួរ​រូបថត​ម៉ាស៊ីន​បម្រើ​ដែល​បាន​ដាក់​ឲ្យ​ប្រើ និង​ត្រឡប់ uuid របស់​រូបថត​ថ្មី ។ រូបថត​ត្រូវ​បាន​រាយ​ភ្លាមៗ​ជាមួយ​នឹង​ការ​កំណត់​រួចរាល់​ទៅ false ។

សិទ្ធិ​ដែល​ត្រូវការ: 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}/

លុប​រូបថត​ Snapshot

ជួរ​រូបថត​សម្រាប់​លុប​ជា​អចិន្ត្រៃយ៍ ។ ការ​លុប​គឺ​ពិត​រហូត​ដល់​វា​បាត់ ។

សិទ្ធិ​ដែល​ត្រូវការ: 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 រក​មិន​ឃើញ ឬ​វា​ជា​របស់​គណនី​ផ្សេង

ចំណាំ