Listi yfir allar skyndimyndir
Sækja lista yfir allar skyndimyndir á netþjónunum þínum.
Fyrirspurnarbreytur
Breyta
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"
Afrita
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())
Afrita
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);
Afrita
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
Búa til mynd af núverandi ástandi miðlara. Myndir eru tímabundnar afrit af öllum miðlaranum.
Færibreytur beiðninnar
Breyta
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"
}'
Afrita
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())
Afrita
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);
Afrita
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
Athugasemd: 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
Endurheimta miðlara í það ástand sem hann var í á mynd. Þetta mun skrifa yfir öll gögn á miðlaranum.
Slóðarbreytur
Breyta
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"
Afrita
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())
Afrita
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);
Afrita
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
Breyta
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"
Afrita
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)
Afrita
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
Skilningur hvenær á að nota snapshots á móti öryggisafrit:
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
Bestu starfsvenjur
Fyrir uppfærslur: Búa til snapshot fyrir helstu kerfi uppfærslur
Prófun: Nota skyndimyndir þegar prófaðar eru stillingarbreytingar
Sameinað stefna: Notaðu bæði skyndimyndir (skammtíma) og öryggisafrit (langtíma)
Hreinsa: Eyða gömlum myndskeiðum eftir árangursríkar uppfærslur
Staða þjóns: Íhuga að stöðva miðlarann áður en mikilvægar myndskeið eru búnar til