Liostaigh Gach Grianghraf
Aisghabh liosta de na pictiúir go léir ar fud do fhreastalaithe.
Paraiméadair Iarratais
Paraiméadair
Cineál
Riachtanach
Cur Síos
server_id
integer
& Ná Sábháil
Scag na pictiúir de réir aitheantóir an fhreastalaí
Iarratas Samplach
curl -X GET "https://admin.vps.org/api/v1/snapshots/?server_id=12345" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"
Cóipeáil
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())
Cóipeáil
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);
Cóipeáil
Freagra Samplach
{
"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"
}
]
}
Cóid Stádas Freagartha
200
Aisghabhadh liosta pictiúr go rathúil
401
Neamhúdaraithe - Comhartha fíordheimhnithe neamhbhailí nó ar iarraidh
Cruthaigh Pictiúr
Cruthaigh seansanna de staid reatha an fhreastalaí. Is cóipeanna pointe- in- am den fhreastalaí iomlán iad seansanna.
Paraiméadair Chomhlacht an Iarratais
Paraiméadair
Cineál
Riachtanach
Cur Síos
server_id
integer
Tá
ID an fhreastalaí le pictiúr a thógáil
name
string
Tá
Ainm don phictiúr (alfa-uimhriúil, fleiscíní, fo-línte)
description
string
& Ná Sábháil
Cur síos roghnach don phictiúr
Iarratas Samplach
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"
}'
Cóipeáil
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())
Cóipeáil
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);
Cóipeáil
Freagra Samplach
{
"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."
}
Cóid Stádas Freagartha
201
Cuireadh tús le cruthú pictiúr go rathúil
400
Bad Request - Invalid parameters or snapshot limit reached
401
Neamhúdaraithe - Comhartha fíordheimhnithe neamhbhailí nó ar iarraidh
404
Not Found - Server does not exist
Nóta: 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.
Athchóirigh ó Snapshot
Athchóirigh freastalaí go dtí an staid a gabhadh i seansanna. Forscríobhfaidh sé seo na sonraí reatha ar an bhfreastalaí.
Paraiméadair na gCosán
Paraiméadair
Cineál
Riachtanach
Cur Síos
snapshot_id
integer
Tá
ID uathúil pictiúr
Iarratas Samplach
curl -X POST "https://admin.vps.org/api/v1/snapshots/801/restore/" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"
Cóipeáil
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())
Cóipeáil
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);
Cóipeáil
Freagra Samplach
{
"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"
}
}
Cóid Stádas Freagartha
200
Cuireadh tús leis an athchóiriú go rathúil
400
Bad Request - Server is not in a valid state for restoration
401
Neamhúdaraithe - Comhartha fíordheimhnithe neamhbhailí nó ar iarraidh
404
Ní bhfuarthas - Níl an pictiúr ann
Rabhadh: 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.
Scrios an pictiúr
Scrios pictiúr go buan. Ní féidir an gníomh seo a chealú.
Paraiméadair na gCosán
Paraiméadair
Cineál
Riachtanach
Cur Síos
snapshot_id
integer
Tá
ID uathúil pictiúr
Iarratas Samplach
curl -X DELETE "https://admin.vps.org/api/v1/snapshots/801/" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"
Cóipeáil
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)
Cóipeáil
Cóid Stádas Freagartha
204
Scriosadh an pictiúr go rathúil
401
Neamhúdaraithe - Comhartha fíordheimhnithe neamhbhailí nó ar iarraidh
404
Ní bhfuarthas - Níl an pictiúr ann
Snapshots vs Backups
Tuiscint a fháil nuair a úsáid snapshots i gcoinne cúltacaí:
API Grianghrafadóireachta
Cuspóir: Quick point-in-time recovery
Luas: Faster to create and restore (3-15 min)
Cás Úsáide: Before risky operations (updates, config changes)
Stóráil: Stored on same infrastructure
Teorainn: 5 snapshots per server
Is Fearr Do: Short-term rollback capability
API Cúltacaí
Cuspóir: Long-term data protection
Luas: Slower to create and restore (varies)
Cás Úsáide: Regular automated data protection
Stóráil: Separate backup storage
Teorainn: 10 manual + automatic backups
Is Fearr Do: Disaster recovery and compliance
Dea-chleachtais
Roimh Nuashonruithe: Cruthaigh seansanna roimh nuashonruithe móra córais
Tástáil: Úsáid seansanna agus athruithe cumraíochta á dtástáil
Straitéis Chomhcheangailte: Bain úsáid as an dá snapshots (gearrthéarmach) agus cúltacaí (fadtéarmach)
Glan Suas: Scrios sean- sheansanna tar éis nuashonruithe rathúla
Stádas an Fhreastalaí: Smaoinigh ar an bhfreastalaí a stopadh sula gcruthófar seansanna criticiúla