VPS.org API

ឯកសារ REST API

API បម្រុងទុក

រាយ​បម្រុង​ទុក​ម៉ាស៊ីន​បម្រើ​របស់​អ្នក ចាប់ផ្ដើម​បម្រុង​ទុក​ថ្មី និង​ស្ដារ​ម៉ាស៊ីន​បម្រើ​ពី​មួយ ។

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

រាយបញ្ជីការបម្រុងទុកទាំងអស់

ត្រឡប់​ការ​បម្រុង​ទុក​របស់​ម៉ាស៊ីន​បម្រើ​របស់​អ្នក​ទាំងអស់ ថ្មី​បំផុត​ដំបូង ២៥ ក្នុង​មួយ​ទំព័រ ។ គ្មាន​តម្រង​ម៉ាស៊ីន​បម្រើ ៖ ប្រើ 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 ថ្ងៃ​ទាំងមូល​ដែល​នៅ​សល់​រហូត​ដល់​កាលបរិច្ឆេទ​លុប
created_at datetime ពេលវេលា​បង្កើត (ISO 8601 ពេលវេលា​សហគមន៍​អន្តរជាតិ)

លេខកូដស្ថានភាពឆ្លើយតប

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 រក​មិន​ឃើញ ឬ​វា​ជា​របស់​គណនី​ផ្សេង

ចំណាំ