Thathamisa Lifoto Tsohle tse Khutšoanyane
Fumana lethathamo la linepe tsohle ho li-server tsa hau.
Liparamitha tsa Potso
Parameter
Mofuta
E hlokahala
Bophara
server_id
integer
Ha ho joalo
Hlopha linepe ka ID ea seva
Kopo ea Mohlala
curl -X GET "https://admin.vps.org/api/v1/snapshots/?server_id=12345" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"
Kopa
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())
Kopa
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);
Kopa
Karabo ea Mohlala
{
"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"
}
]
}
Likhoutu tsa Boemo ba Karabelo
200
Lethathamo la linepe tse khutlileng ka katleho
401
Ha ea lumelloa - Tokeno ea netefatso e fosahetseng kapa e sieo
Theha Senepe se Sekhutšoanyane
E etsa setšoantšo sa boemo ba setsi sa marang-rang kajeno. Li-snapshots ke likopi tsa nako-ka-letsatsi tsa setsi sa marang-rang ka bophara.
Kopa Liparamente tsa 'Mele
Parameter
Mofuta
E hlokahala
Bophara
server_id
integer
E
ID ea seva eo u ka e nkang setšoantšong
name
string
E
Lebitso la setšoantšo (mabitso a litlhaku, li-hyphen, li-underscore)
description
string
Ha ho joalo
Tlhaloso ea boikhethelo bakeng sa setšoantšo
Kopo ea Mohlala
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"
}'
Kopa
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())
Kopa
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);
Kopa
Karabo ea Mohlala
{
"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."
}
Likhoutu tsa Boemo ba Karabelo
201
Tlhahiso ea linepe e qalile ka katleho
400
Bad Request - Invalid parameters or snapshot limit reached
401
Ha ea lumelloa - Tokeno ea netefatso e fosahetseng kapa e sieo
404
Not Found - Server does not exist
Tlhaloso: 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.
Khutlisa ho tsoa ho Snapshot
Ntša sebaka sa marang-rang ho ea boemong bo neng bo nkoa ka snapshot. Sena se tla ngola ka ho feletseng data ea hona joale sebakeng sa marang-rang.
Liparamitha tsa Tsela
Parameter
Mofuta
E hlokahala
Bophara
snapshot_id
integer
E
ID ea setšoantšo se ikhethang
Kopo ea Mohlala
curl -X POST "https://admin.vps.org/api/v1/snapshots/801/restore/" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"
Kopa
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())
Kopa
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);
Kopa
Karabo ea Mohlala
{
"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"
}
}
Likhoutu tsa Boemo ba Karabelo
200
Tsosoloso e qaliloe ka katleho
400
Bad Request - Server is not in a valid state for restoration
401
Ha ea lumelloa - Tokeno ea netefatso e fosahetseng kapa e sieo
404
Ha e Fumanehe - Setšoantšo se senyenyane ha se eo
Temoso: 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.
Hlakola Senepe sa Kakaretso
Hlakola setšoantšo ka ho sa feleng. Ketso ena e ke ke ea etsolloa.
Liparamitha tsa Tsela
Parameter
Mofuta
E hlokahala
Bophara
snapshot_id
integer
E
ID ea setšoantšo se ikhethang
Kopo ea Mohlala
curl -X DELETE "https://admin.vps.org/api/v1/snapshots/801/" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"
Kopa
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)
Kopa
Likhoutu tsa Boemo ba Karabelo
204
Setšoantšo se sekhutšoanyane se hlakotsoe ka katleho
401
Ha ea lumelloa - Tokeno ea netefatso e fosahetseng kapa e sieo
404
Ha e Fumanehe - Setšoantšo se senyenyane ha se eo
Snapshots vs Backups
Ho utloisisa ha ho hlokahala hore u sebelise snapshots versus backups:
Lifoto tsa Snapshot tsa API
Morero: Quick point-in-time recovery
Lebelo: Faster to create and restore (3-15 min)
Nyeoe ea Tšebeliso: Before risky operations (updates, config changes)
Polokelo: Stored on same infrastructure
Boholo: 5 snapshots per server
Molemo ka ho Fetisisa Bakeng sa: Short-term rollback capability
API ea Li-backup
Morero: Long-term data protection
Lebelo: Slower to create and restore (varies)
Nyeoe ea Tšebeliso: Regular automated data protection
Polokelo: Separate backup storage
Boholo: 10 manual + automatic backups
Molemo ka ho Fetisisa Bakeng sa: Disaster recovery and compliance
Likarolo
Pele ho lintlafatso: E etsa snapshot pele ho ho nchafatsa sistimi e kholo
Ho leka: Senya lifoto ha u leka liphetoho tsa ho kenya
Litsela tse kopaneng: Senya lifoto tsa snapshot (ka nako e khuts'oane) le likopi tsa polokelo (ka nako e telele)
Ho hloekisa: Ho tlosa lifoto tse fetileng ka mor'a ho nchafatsoa ka katleho
Mofuta oa setsi: Ho nahana ka ho thibela setsi pele ho etsa lifoto tse kotsi