Dwelisa Zonke Iifoto Ezifutshane
Fumana uluhlu lwazo zonke iifoto ezimfutshane kwiiseva zakho.
IiParamitha zoMbuzo
Iparamitha
Uhlobo
Kufuneka
Inkcazelo
server_id
integer
Akukho nanye
Hluza izifinyezo nge-ID yeseva
Isicelo somzekelo
curl -X GET "https://admin.vps.org/api/v1/snapshots/?server_id=12345" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"
& Khuphela
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())
& Khuphela
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);
& Khuphela
Impendulo yoMzekelo
{
"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"
}
]
}
Iikhowudi zeMeko yokuphendula
200
Uluhlu lwesnapshot lufunyenwe ngempumelelo
401
Ayigunyaziswanga - Ithokheni yokuqinisekisa engasebenziyo okanye engekhoyo
Yenza i-Snapshot
Dala umfanekiso ongumqondiso wesimo sangoku seseva. Imifanekiso eqingqiweyo yikopi yexesha-lendawo yeseva yonke.
Cela iiParamitha zoMzimba
Iparamitha
Uhlobo
Kufuneka
Inkcazelo
server_id
integer
Ewe
Isazisi seseva ukuze sithathwe umfanekiso
name
string
Ewe
Igama le-snapshot (i-alphanumeric, i-hyphens, i-underscores)
description
string
Akukho nanye
Inkcazo yokuzikhethela yesnapshot
Isicelo somzekelo
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"
}'
& Khuphela
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())
& Khuphela
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);
& Khuphela
Impendulo yoMzekelo
{
"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."
}
Iikhowudi zeMeko yokuphendula
201
Ukudalwa kwemifanekiso eqingqiweyo kuqaliswe ngempumelelo
400
Bad Request - Invalid parameters or snapshot limit reached
401
Ayigunyaziswanga - Ithokheni yokuqinisekisa engasebenziyo okanye engekhoyo
404
Not Found - Server does not exist
& Incwadi eneenkcukacha Entsha... 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.
Buyisela kwi-Snapshot
Buyisela umncedisi kwimeko ethathwe kwiskrini esikhawulezayo. Oku kuza kubhala ngaphezulu yonke i-data yangoku kumncedisi.
Iiparameter zeNdlela
Iparamitha
Uhlobo
Kufuneka
Inkcazelo
snapshot_id
integer
Ewe
I-ID yesnapshot eyahlukileyo
Isicelo somzekelo
curl -X POST "https://admin.vps.org/api/v1/snapshots/801/restore/" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"
& Khuphela
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())
& Khuphela
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);
& Khuphela
Impendulo yoMzekelo
{
"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"
}
}
Iikhowudi zeMeko yokuphendula
200
Ukubuyisela kuqaliswe ngempumelelo
400
Bad Request - Server is not in a valid state for restoration
401
Ayigunyaziswanga - Ithokheni yokuqinisekisa engasebenziyo okanye engekhoyo
404
Ayifumaneki - Umfanekiso omfutshane awukho
Isilumkiso: 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.
Cima iSnapshot
Cima umfanekiso omfutshane ngokusisigxina. Esi senzo asinakurhoxiswa.
Iiparameter zeNdlela
Iparamitha
Uhlobo
Kufuneka
Inkcazelo
snapshot_id
integer
Ewe
I-ID yesnapshot eyahlukileyo
Isicelo somzekelo
curl -X DELETE "https://admin.vps.org/api/v1/snapshots/801/" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"
& Khuphela
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)
& Khuphela
Iikhowudi zeMeko yokuphendula
204
Umfanekiso omfutshane ucinywe ngempumelelo
401
Ayigunyaziswanga - Ithokheni yokuqinisekisa engasebenziyo okanye engekhoyo
404
Ayifumaneki - Umfanekiso omfutshane awukho
Snapshots vs Backups
Ukuqonda xa usebenzisa iifoto ezikhawulezayo versus iindawo zokugcina:
Iifoto ze-Snapshots API
Injongo: Quick point-in-time recovery
Isantya: Faster to create and restore (3-15 min)
Ityala Lokusetyenziswa: Before risky operations (updates, config changes)
Indawo yokugcina: Stored on same infrastructure
Umda: 5 snapshots per server
Eyona ilungileyo: Short-term rollback capability
I-API yee-Backups
Injongo: Long-term data protection
Isantya: Slower to create and restore (varies)
Ityala Lokusetyenziswa: Regular automated data protection
Indawo yokugcina: Separate backup storage
Umda: 10 manual + automatic backups
Eyona ilungileyo: Disaster recovery and compliance
Iinkqubo ezilungileyo
Phambi Kokugqiba: Dala umfanekiso ongumqondiso phambi kohlaziyo olukhulu lwenkqubo
Uvavanyo: Sebenzisa imifanekiso eqingqiweyo xa uvavanya izicwangciso zezinto eziguqukayo
Inkqubo yolawulo Sebenzisa zombini iifoto ezikhawulezayo (ezifutshane) kunye neengxelo zokhuseleko (ezide)
Cacisa: Cima imifanekiso eqingqiweyo edlulileyo emva kokuhlaziya okuphumelelayo
Inkqubo yeseva: Qiniseka ukuba umisa iseva phambi kokuba udale imifanekiso ekhawulezayo ebalulekileyo