ລາຍຊື່ Snapshot ທັງໝົດ
ດຶງເອົາລາຍຊື່ຂອງ snapshots ທັງໝົດໃນທົ່ວເຊີບເວີຂອງທ່ານ.
ພາລາມິເຕີການສອບຖາມ
ຕົວເລືອກ
ປະເພດ
ຕ້ອງມີການ
ຄໍາອະທິບາຍ
server_id
integer
ບໍ່
ກັ່ນຕອງ snapshots ຕາມ ID ເຊີບເວີ
ຕົວຢ່າງການຮ້ອງຂໍ
curl -X GET "https://admin.vps.org/api/v1/snapshots/?server_id=12345" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"
ចម្លង
import requests
url = "https://admin.vps.org/api/v1/snapshots/"
headers = {
"Authorization": "Bearer YOUR_API_TOKEN",
"Content-Type": "application/json"
}
params = {"server_id": 12345}
response = requests.get(url, headers=headers, params=params)
print(response.json())
ចម្លង
const response = await fetch('https://admin.vps.org/api/v1/snapshots/?server_id=12345', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_API_TOKEN',
'Content-Type': 'application/json'
}
});
const snapshots = await response.json();
console.log(snapshots);
ចម្លង
ຕົວຢ່າງການຕອບສະໜອງ
{
"count": 2,
"results": [
{
"id": 801,
"server": {
"id": 12345,
"name": "web-server-01"
},
"name": "pre-migration-snapshot",
"status": "completed",
"size_mb": 5120,
"created_at": "2025-01-15T18:30:00Z",
"description": "Before major migration"
},
{
"id": 798,
"server": {
"id": 12345,
"name": "web-server-01"
},
"name": "weekly-snapshot-2025-01-08",
"status": "completed",
"size_mb": 4856,
"created_at": "2025-01-08T12:00:00Z",
"description": "Weekly snapshot"
}
]
}
ລະຫັດສະຖານະການຕອບສະໜອງ
200
ດຶງຂໍ້ມູນລາຍຊື່ສະແນັບຊັອດສຳເລັດແລ້ວ
401
ບໍ່ໄດ້ຮັບອະນຸຍາດ - ໂທເຄັນການພິສູດຢືນຢັນບໍ່ຖືກຕ້ອງ ຫຼື ບໍ່ມີ
ສ້າງ Snapshot
ສ້າງຮູບຖ່າຍຂອງສະຖານະປັດຈຸບັນຂອງເຊີບເວີ. ຮູບຖ່າຍແມ່ນການຖ່າຍແບບຂອງເວລາຂອງເຊີບເວີທັງໝົດ.
ຮ້ອງຂໍພາລາມິເຕີຂອງຮ່າງກາຍ
ຕົວເລືອກ
ປະເພດ
ຕ້ອງມີການ
ຄໍາອະທິບາຍ
server_id
integer
ແມ່ນແລ້ວ
ID ຂອງເຊີບເວີເພື່ອ snapshot
name
string
ແມ່ນແລ້ວ
ຊື່ສຳລັບ snapshot (ຕົວອັກສອນ ແລະ ຕົວເລກ, ເຄື່ອງໝາຍຂີດ, ເຄື່ອງໝາຍຂີດລຸ່ມ)
description
string
ບໍ່
ຄຳອະທິບາຍທາງເລືອກສຳລັບ snapshot
ຕົວຢ່າງການຮ້ອງຂໍ
curl -X POST "https://admin.vps.org/api/v1/snapshots/" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"server_id": 12345,
"name": "before-update-snapshot",
"description": "Snapshot before system update"
}'
ចម្លង
import requests
url = "https://admin.vps.org/api/v1/snapshots/"
headers = {
"Authorization": "Bearer YOUR_API_TOKEN",
"Content-Type": "application/json"
}
data = {
"server_id": 12345,
"name": "before-update-snapshot",
"description": "Snapshot before system update"
}
response = requests.post(url, headers=headers, json=data)
print(response.json())
ចម្លង
const response = await fetch('https://admin.vps.org/api/v1/snapshots/', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_TOKEN',
'Content-Type': 'application/json'
},
body: JSON.stringify({
server_id: 12345,
name: 'before-update-snapshot',
description: 'Snapshot before system update'
})
});
const snapshot = await response.json();
console.log(snapshot);
ចម្លង
ຕົວຢ່າງການຕອບສະໜອງ
{
"id": 802,
"server": {
"id": 12345,
"name": "web-server-01"
},
"name": "before-update-snapshot",
"status": "in_progress",
"size_mb": null,
"created_at": "2025-01-16T16:15:00Z",
"description": "Snapshot before system update",
"message": "Snapshot is being created. This may take 3-10 minutes depending on server size."
}
ລະຫັດສະຖານະການຕອບສະໜອງ
201
ການສ້າງ Snapshot ເລີ່ມຕົ້ນສຳເລັດແລ້ວ
400
Bad Request - Invalid parameters or snapshot limit reached
401
ບໍ່ໄດ້ຮັບອະນຸຍາດ - ໂທເຄັນການພິສູດຢືນຢັນບໍ່ຖືກຕ້ອງ ຫຼື ບໍ່ມີ
404
Not Found - Server does not exist
ចំណាំ: You can have a maximum of 5 snapshots per server. Creating a snapshot while the server is running may result in filesystem inconsistencies. For best results, stop the server before creating a snapshot.
ກູ້ຄືນຈາກ Snapshot
ຟື້ນຟູເຄື່ອງຮັບສົ່ງຄືນໄປສູ່ສະຖານະທີ່ໄດ້ຖ່າຍໃນຮູບຖ່າຍທັນທີ. ສິ່ງນີ້ຈະຂຽນເປັນລາຍຊື່ຂໍ້ມູນທີ່ມີຢູ່ໃນປັດຈຸບັນທັງໝົດທີ່ຢູ່ເທິງເຄື່ອງຮັບສົ່ງ.
ພາລາມິເຕີເສັ້ນທາງ
ຕົວເລືອກ
ປະເພດ
ຕ້ອງມີການ
ຄໍາອະທິບາຍ
snapshot_id
integer
ແມ່ນແລ້ວ
ID ສະແນັບຊັອດທີ່ເປັນເອກະລັກ
ຕົວຢ່າງການຮ້ອງຂໍ
curl -X POST "https://admin.vps.org/api/v1/snapshots/801/restore/" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"
ចម្លង
import requests
snapshot_id = 801
url = f"https://admin.vps.org/api/v1/snapshots/{snapshot_id}/restore/"
headers = {
"Authorization": "Bearer YOUR_API_TOKEN",
"Content-Type": "application/json"
}
response = requests.post(url, headers=headers)
print(response.json())
ចម្លង
const snapshotId = 801;
const response = await fetch(`https://admin.vps.org/api/v1/snapshots/${snapshotId}/restore/`, {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_TOKEN',
'Content-Type': 'application/json'
}
});
const result = await response.json();
console.log(result);
ចម្លង
ຕົວຢ່າງການຕອບສະໜອງ
{
"status": "success",
"message": "Server is being restored from snapshot. This may take 5-15 minutes.",
"snapshot": {
"id": 801,
"name": "pre-migration-snapshot",
"created_at": "2025-01-15T18:30:00Z"
},
"server": {
"id": 12345,
"name": "web-server-01",
"status": "restoring"
}
}
ລະຫັດສະຖານະການຕອບສະໜອງ
200
ການກູ້ຄືນເລີ່ມຕົ້ນສຳເລັດແລ້ວ
400
Bad Request - Server is not in a valid state for restoration
401
ບໍ່ໄດ້ຮັບອະນຸຍາດ - ໂທເຄັນການພິສູດຢືນຢັນບໍ່ຖືກຕ້ອງ ຫຼື ບໍ່ມີ
404
ບໍ່ພົບ - ບໍ່ມີ Snapshot
ຄຳເຕືອນ: Restoring from a snapshot will overwrite all current data on the server. This action cannot be undone. The server will be automatically stopped before restoration begins.
ລຶບສະແນັບຊັອດ
ລຶບ snapshot ອອກຢ່າງຖາວອນ. ການກະທຳນີ້ບໍ່ສາມາດຍົກເລີກໄດ້.
ພາລາມິເຕີເສັ້ນທາງ
ຕົວເລືອກ
ປະເພດ
ຕ້ອງມີການ
ຄໍາອະທິບາຍ
snapshot_id
integer
ແມ່ນແລ້ວ
ID ສະແນັບຊັອດທີ່ເປັນເອກະລັກ
ຕົວຢ່າງການຮ້ອງຂໍ
curl -X DELETE "https://admin.vps.org/api/v1/snapshots/801/" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"
ចម្លង
import requests
snapshot_id = 801
url = f"https://admin.vps.org/api/v1/snapshots/{snapshot_id}/"
headers = {
"Authorization": "Bearer YOUR_API_TOKEN",
"Content-Type": "application/json"
}
response = requests.delete(url, headers=headers)
print(response.status_code)
ចម្លង
ລະຫັດສະຖານະການຕອບສະໜອງ
204
ລຶບ Snapshot ສຳເລັດແລ້ວ
401
ບໍ່ໄດ້ຮັບອະນຸຍາດ - ໂທເຄັນການພິສູດຢືນຢັນບໍ່ຖືກຕ້ອງ ຫຼື ບໍ່ມີ
404
ບໍ່ພົບ - ບໍ່ມີ Snapshot
Snapshots vs Backups
ເຂົ້າໃຈເວລາທີ່ໃຊ້ snapshots versus バックອັບ:
API ສະແນັບຊັອດ
ຈຸດປະສົງ: Quick point-in-time recovery
ຄວາມໄວ: Faster to create and restore (3-15 min)
ກໍລະນີການໃຊ້: Before risky operations (updates, config changes)
ການເກັບຮັກສາ: Stored on same infrastructure
ຈໍາກັດ: 5 snapshots per server
ດີທີ່ສຸດສຳລັບ: Short-term rollback capability
API ສຳຮອງຂໍ້ມູນ
ຈຸດປະສົງ: Long-term data protection
ຄວາມໄວ: Slower to create and restore (varies)
ກໍລະນີການໃຊ້: Regular automated data protection
ການເກັບຮັກສາ: Separate backup storage
ຈໍາກັດ: 10 manual + automatic backups
ດີທີ່ສຸດສຳລັບ: Disaster recovery and compliance
ວິທີທີ່ດີທີ່ສຸດ
ກ່ອນການເຮັດໃຫ້ທັນສະໄໝ: ສ້າງຮູບຖ່າຍກ່ອນການອັບເດດລະບົບໃຫຍ່
ການທົດສອບ & # 160; ៖ ໃຊ້ຮູບຖ່າຍເມື່ອທົດສອບການປ່ຽນແປງການຕັ້ງຄ່າ
ຍຸດທະສາດລວມ: ໃຊ້ທັງສອງ snapshots (ໄລຍະສັ້ນ) ແລະ ການບໍາລຸງຮັກສາ (ໄລຍະຍາວ)
ເຮັດຄວາມສະອາດ: ລຶບຮູບຖ່າຍເກົ່າ ຫຼັງຈາກທີ່ໄດ້ເຮັດໃຫ້ທັນສະໄໝແລ້ວ
ສະຖານະម៉ាស៊ីនបម្រើ & # 160; ៖ ພິຈາລະນາຢຸດເຄື່ອງຮັບກ່ອນທີ່ຈະສ້າງຮູບຖ່າຍທີ່ສຳຄັນ