सबै स्न्यापसटहरू सूचीबद्ध गर्नुहोस्
तपाईंको सर्भरहरूमा भएका सबै स्न्यापसटहरूको सूची प्राप्त गर्नुहोस्।
क्वेरी प्यारामिटरहरू
परिमिति
प्रकारहरू
आवश्यक छ
वर्णन
server_id
integer
होइन
सर्भर 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
अनधिकृत - अमान्य वा हराइरहेको प्रमाणीकरण टोकन
स्न्यापसट सिर्जना गर्नुहोस्
सर्भरको हालको स्थितिको स्न्यापसट सिर्जना गर्नुहोस् । स्न्यापसटहरू सम्पूर्ण सर्भरको बिन्दु-मा-समय प्रतिलिपिहरू हुन् ।
अनुरोध बडी प्यारामिटरहरू
परिमिति
प्रकारहरू
आवश्यक छ
वर्णन
server_id
integer
हो
स्न्यापसटको लागि सर्भरको आईडी
name
string
हो
स्न्यापसटको नाम (अक्षरांक, हाइफन, अन्डरस्कोर)
description
string
होइन
स्न्यापसटको लागि वैकल्पिक विवरण
उदाहरण अनुरोध
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
स्न्यापसट सिर्जना सफलतापूर्वक सुरु भयो
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_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
फेला परेन - स्न्यापसट अवस्थित छैन
चेतावनी: 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_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
स्न्यापसट सफलतापूर्वक मेटाइयो
401
अनधिकृत - अमान्य वा हराइरहेको प्रमाणीकरण टोकन
404
फेला परेन - स्न्यापसट अवस्थित छैन
Snapshots vs Backups
जब स्नेपशॉटहरू प्रयोग गर्नको लागि ब्याकअपहरूको तुलनामा बुझ्दै:
स्न्यापसट 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
उत्तम अभ्यास
अद्यावधिक गर्नु अघि: मुख्य प्रणाली अद्यावधिक गर्नु अघि स्न्यापसट सिर्जना गर्नुहोस्
परीक्षण: कन्फिगरेसन परिवर्तन परीक्षण गर्दा स्न्यापसट प्रयोग गर्नुहोस्
संयोजन रणनीति: दुवै स्न्यापसट (छोटो अवधि) र जगेडा (लामो अवधि) प्रयोग गर्नुहोस्
खाली गर्नुहोस्: सफल अद्यावधिक पछि पुराना स्न्यापसटहरू मेट्नुहोस्
सर्भर स्थिति: महत्वपूर्ण स्न्यापसट सिर्जना गर्नु अघि सर्भर रोक्न विचार गर्नुहोस्