VPS.org API

ເອກະສານ REST API

API ສຳຮອງຂໍ້ມູນ

ລາຍຊື່​ການ​ບໍາລຸງຮັກສາ​ຂອງ​ເຊີບເວີ, ເລີ່ມຕົ້ນ​ການ​ບໍາລຸງຮັກສາ​ໃໝ່ ແລະ ຟື້ນຟູ​ເຊີບເວີ​ຈາກ​ຫນຶ່ງ.

ຈຸດສິ້ນສຸດ 4
ເສັ້ນທາງພື້ນຖານ /api/v1/backups
ຮັບ /api/v1/backups/

ລາຍຊື່ການສຳຮອງຂໍ້ມູນທັງໝົດ

ສົ່ງ​ຄືນ​ການ​ບີບ​ອັດ​ຂອງ​ເຊີບເວີ​ທັງ​ໝົດ​ຂອງ​ທ່ານ, ໃກ້​ສຸດ​ກ່ອນ, 25 ຕໍ່​ໜ້າ. ບໍ່ມີ​ຕົວ​ກັ່ນຕອງ​ເຊີບເວີ: ໃຊ້ server_ hostname ເພື່ອ​ຈັດ​ກຸ່ມ​ພວກ​ມັນ.

ຕ້ອງການ​ສິດ​ອຳນາດ: backups:list

ພາລາມິເຕີການສອບຖາມ

ຕົວ​ເລືອກ​ ປະເພດ ຕ້ອງມີການ ຄໍາອະທິບາຍ
page integer ​ບໍ່ ຕົວເລກ​ໜ້າ, ເລີ່ມ​ຈາກ 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 ຕົວ​ລະບຸ​ການ​ບໍາລຸງ​ຮັກສາ, ຖືກ​ໃຊ້​ໂດຍ​ຈຸດ​ຈົບ​ການ​ເກັບ ແລະ ຟື້ນຟູ
server_hostname string ຊື່​ເຄື່ອງ​ຂອງ​ເຄື່ອງ​ຮັບ​ທີ່​ໄດ້​ເກັບ​ໄວ້
name string ຊື່​ແຟ້ມ​ບັນທຶກ​ການ​ບໍາລຸງ​ຮັກສາ
size_gb number ຂະໜາດ​ທີ່​ໄດ້​ບີບອັດ​ເປັນ​ຈີ​ກາ​ບິດ
deletion_date datetime ເມື່ອ​ການ​ບໍາລຸງຮັກສາ​ຈະ​ຖືກ​ເອົາອອກ​ໂດຍ​ອັດຕະໂນມັດ
days_remaining integer ມື້​ທີ່​ເຫຼືອ​ຈົນ​ເຖິງ​ວັນ​ລຶບ
created_at datetime ເວລາ​ສ້າງ (ISO 8601, UTC)

ລະຫັດສະຖານະການຕອບສະໜອງ

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 ບໍ່ພົບ ຫຼື ມັນເປັນສ່ວນຂອງບັນຊີອື່ນ

ບັນທຶກ