Orodhesha Picha Zote Muhtasari
Pata orodha ya picha zote kwenye seva zako.
Vigezo vya Hoja
Penseli
Aina
Inahitajika
Maelezo
server_id
integer
Hapana
Chuja picha kwa kitambulisho cha seva
Ombi la Mfano
curl -X GET "https://admin.vps.org/api/v1/snapshots/?server_id=12345" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"
Nakala
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())
Nakala
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);
Nakala
Jibu la Mfano
{
"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"
}
]
}
Misimbo ya Hali ya Majibu
200
Imefanikiwa kurejesha orodha ya picha
401
Hairuhusiwi - Tokeni ya uthibitishaji si sahihi au haipo
Unda Picha Muhtasari
Andaa picha ya jimbo la sasa la mtumikiaji. Snapshots ni nakala za moja kwa moja za mtumishi mzima.
Omba Vigezo vya Mwili
Penseli
Aina
Inahitajika
Maelezo
server_id
integer
Ndiyo
Kitambulisho cha seva cha kupiga picha
name
string
Ndiyo
Jina la picha (alfabeti, vistari, mistari ya chini)
description
string
Hapana
Maelezo ya hiari kwa picha
Ombi la Mfano
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"
}'
Nakala
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())
Nakala
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);
Nakala
Jibu la Mfano
{
"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."
}
Misimbo ya Hali ya Majibu
201
Uundaji wa picha umeanzishwa kwa mafanikio
400
Bad Request - Invalid parameters or snapshot limit reached
401
Hairuhusiwi - Tokeni ya uthibitishaji si sahihi au haipo
404
Not Found - Server does not exist
Angalia: 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.
Rejesha kutoka kwa Picha ya Muhtasari
Rudieni mlinzi wa serikali aliyekamatwa kwa picha. Hii itaweka habari zote za hivi karibuni juu ya kampuni hiyo.
Vigezo vya Njia
Penseli
Aina
Inahitajika
Maelezo
snapshot_id
integer
Ndiyo
Kitambulisho cha picha cha kipekee
Ombi la Mfano
curl -X POST "https://admin.vps.org/api/v1/snapshots/801/restore/" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"
Nakala
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())
Nakala
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);
Nakala
Jibu la Mfano
{
"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"
}
}
Misimbo ya Hali ya Majibu
200
Urejeshaji umeanzishwa kwa mafanikio
400
Bad Request - Server is not in a valid state for restoration
401
Hairuhusiwi - Tokeni ya uthibitishaji si sahihi au haipo
404
Haipatikani - Picha ya haraka haipo
Onyo: 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.
Futa Muhtasari
Futa picha ya moja kwa moja. Kitendo hiki hakiwezi kutenduliwa.
Vigezo vya Njia
Penseli
Aina
Inahitajika
Maelezo
snapshot_id
integer
Ndiyo
Kitambulisho cha picha cha kipekee
Ombi la Mfano
curl -X DELETE "https://admin.vps.org/api/v1/snapshots/801/" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"
Nakala
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)
Nakala
Misimbo ya Hali ya Majibu
204
Picha ya haraka imefutwa kwa mafanikio
401
Hairuhusiwi - Tokeni ya uthibitishaji si sahihi au haipo
404
Haipatikani - Picha ya haraka haipo
Snapshots vs Backups
Kuelewa wakati wa kutumia picha dhidi ya michomozo:
API ya Vijipicha
Kusudi: Quick point-in-time recovery
Kasi: Faster to create and restore (3-15 min)
Kesi ya Matumizi: Before risky operations (updates, config changes)
Hifadhi: Stored on same infrastructure
Mipaka: 5 snapshots per server
Bora kwa: Short-term rollback capability
API ya Hifadhi Rudufu
Kusudi: Long-term data protection
Kasi: Slower to create and restore (varies)
Kesi ya Matumizi: Regular automated data protection
Hifadhi: Separate backup storage
Mipaka: 10 manual + automatic backups
Bora kwa: Disaster recovery and compliance
Mazoea Bora
Kabla ya Habari Mpya: Andaa picha kabla ya taarifa kuu za mfumo
Kutahini: Tumia picha wakati wa mabadiliko ya vipimo
Mkakati Uliounganishwa: Tumia mihula miwili (ya muda mfupi) na ya nyuma (ya muda mrefu)
Safisha: Insha za zamani baada ya habari zenye mafanikio
Jimbo la Cliver: Fikiria kumzuia mtumishi huyo kabla ya kutoa picha za dharura