બધા સ્નેપશોટની યાદી બનાવો
તમારા સર્વર પરના બધા સ્નેપશોટની સૂચિ મેળવો.
ક્વેરી પરિમાણો
Parameter
પ્રકાર
જરૂરી
Description
server_id
integer
No
સર્વર 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"
Copy
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())
Copy
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);
Copy
ઉદાહરણ પ્રતિભાવ
{
"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
અનધિકૃત - અમાન્ય અથવા ખૂટતું પ્રમાણીકરણ ટોકન
સ્નેપશોટ બનાવો
Create a snapshot of a server's current state. Snapshots are point-in-time copies of the entire server.
બોડી પેરામીટર્સની વિનંતી કરો
Parameter
પ્રકાર
જરૂરી
Description
server_id
integer
હા
સ્નેપશોટ માટે સર્વરનું ID
name
string
હા
સ્નેપશોટ માટે નામ (આલ્ફાન્યૂમેરિક, હાઇફન્સ, અંડરસ્કોર્સ)
description
string
No
સ્નેપશોટ માટે વૈકલ્પિક વર્ણન
ઉદાહરણ વિનંતી
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"
}'
Copy
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())
Copy
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);
Copy
ઉદાહરણ પ્રતિભાવ
{
"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
Note: 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.
સ્નેપશોટમાંથી પુનઃસ્થાપિત કરો
Restore a server to the state captured in a snapshot. This will overwrite all current data on the server.
પાથ પરિમાણો
Parameter
પ્રકાર
જરૂરી
Description
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"
Copy
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())
Copy
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);
Copy
ઉદાહરણ પ્રતિભાવ
{
"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.
સ્નેપશોટ કાઢી નાખો
સ્નેપશોટ કાયમ માટે કાઢી નાખો. આ ક્રિયા પૂર્વવત્ કરી શકાતી નથી.
પાથ પરિમાણો
Parameter
પ્રકાર
જરૂરી
Description
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"
Copy
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)
Copy
પ્રતિભાવ સ્થિતિ કોડ્સ
204
સ્નેપશોટ સફળતાપૂર્વક કાઢી નાખ્યો
401
અનધિકૃત - અમાન્ય અથવા ખૂટતું પ્રમાણીકરણ ટોકન
404
મળ્યું નથી - સ્નેપશોટ અસ્તિત્વમાં નથી
Snapshots vs Backups
Understanding when to use snapshots versus 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
Limit: 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
Limit: 10 manual + automatic backups
શ્રેષ્ઠ: Disaster recovery and compliance
Best Practices
Before Updates: Create a snapshot before major system updates
Testing: Use snapshots when testing configuration changes
Combined Strategy: Use both snapshots (short-term) and backups (long-term)
Clean Up: Delete old snapshots after successful updates
Server State: Consider stopping the server before creating critical snapshots