Listi yfir allar skyndimyndir
Sækja lista yfir allar skyndimyndir á netþjónunum þínum.
Fyrirspurnarbreytur
Færibreyta
Tegund
Nauðsynlegt
Lýsing
server_id
integer
Nei
Sía skyndimyndir eftir netþjónsauðkenni
Dæmi um beiðni
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
Dæmi um svar
{
"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"
}
]
}
Kóðar fyrir svörunarstöðu
200
Listi yfir skyndimyndir sóttur
401
Óheimilt - Ógilt eða vantar auðkenningarlykil
Búa til skyndimynd
Create a snapshot of a server's current state. Snapshots are point-in-time copies of the entire server.
Færibreytur beiðninnar
Færibreyta
Tegund
Nauðsynlegt
Lýsing
server_id
integer
Já
Auðkenni netþjónsins sem á að taka skyndimynd
name
string
Já
Nafn fyrir myndatöku (bókstafir, bandstrik, undirstrik)
description
string
Nei
Valfrjáls lýsing fyrir skyndimyndina
Dæmi um beiðni
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
Dæmi um svar
{
"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."
}
Kóðar fyrir svörunarstöðu
201
Myndataka hefur verið stofnun hafin
400
Bad Request - Invalid parameters or snapshot limit reached
401
Óheimilt - Ógilt eða vantar auðkenningarlykil
404
Not Found - Server does not exist
Athugið: 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.
Endurheimta úr skyndimynd
Restore a server to the state captured in a snapshot. This will overwrite all current data on the server.
Slóðarbreytur
Færibreyta
Tegund
Nauðsynlegt
Lýsing
snapshot_id
integer
Já
Einstakt skyndimyndaauðkenni
Dæmi um beiðni
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
Dæmi um svar
{
"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"
}
}
Kóðar fyrir svörunarstöðu
200
Endurheimt hafin með góðum árangri
400
Bad Request - Server is not in a valid state for restoration
401
Óheimilt - Ógilt eða vantar auðkenningarlykil
404
Fannst ekki - Myndataka er ekki til
Viðvörun: 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.
Eyða skyndimynd
Eyða skyndimynd fyrir fullt og allt. Þessa aðgerð er ekki hægt að afturkalla.
Slóðarbreytur
Færibreyta
Tegund
Nauðsynlegt
Lýsing
snapshot_id
integer
Já
Einstakt skyndimyndaauðkenni
Dæmi um beiðni
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
Kóðar fyrir svörunarstöðu
204
Myndatöku var eytt
401
Óheimilt - Ógilt eða vantar auðkenningarlykil
404
Fannst ekki - Myndataka er ekki til
Snapshots vs Backups
Understanding when to use snapshots versus backups:
Myndatökuforritaskil
Tilgangur: Quick point-in-time recovery
Hraði: Faster to create and restore (3-15 min)
Notkunartilfelli: Before risky operations (updates, config changes)
Geymsla: Stored on same infrastructure
Takmörk: 5 snapshots per server
Best fyrir: Short-term rollback capability
Afritunarforritaskil
Tilgangur: Long-term data protection
Hraði: Slower to create and restore (varies)
Notkunartilfelli: Regular automated data protection
Geymsla: Separate backup storage
Takmörk: 10 manual + automatic backups
Best fyrir: 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