Argazki guztiak zerrendatu
Eskuratu zure zerbitzarietako argazki guztien zerrenda.
Kontsulta-parametroak
Parametroa
Mota
Beharrezkoa
Deskribapena
server_id
integer
Ez
Iragazi argazkiak zerbitzariaren IDaren arabera
Eskaera adibidea
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
Adibide Erantzuna
{
"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"
}
]
}
Erantzun Egoera Kodeak
200
Argazki-zerrenda behar bezala berreskuratu da
401
Baimenik gabea - Autentifikazio-token baliogabea edo falta da
Sortu argazkia
Create a snapshot of a server's current state. Snapshots are point-in-time copies of the entire server.
Eskaeraren Gorputzaren Parametroak
Parametroa
Mota
Beharrezkoa
Deskribapena
server_id
integer
Bai
Argazkia ateratzeko zerbitzariaren IDa
name
string
Bai
Argazkiaren izena (alfabeto-zenbakizkoa, marratxoak, azpimarrak)
description
string
Ez
Argazkiaren deskribapen aukerakoa
Eskaera adibidea
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
Adibide Erantzuna
{
"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."
}
Erantzun Egoera Kodeak
201
Argazki-sorkuntza arrakastaz hasi da
400
Bad Request - Invalid parameters or snapshot limit reached
401
Baimenik gabea - Autentifikazio-token baliogabea edo falta da
404
Not Found - Server does not exist
Oharra: 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.
Leheneratu argazkitik
Restore a server to the state captured in a snapshot. This will overwrite all current data on the server.
Bidearen parametroak
Parametroa
Mota
Beharrezkoa
Deskribapena
snapshot_id
integer
Bai
Argazki-irudiaren ID bakarra
Eskaera adibidea
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
Adibide Erantzuna
{
"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"
}
}
Erantzun Egoera Kodeak
200
Leheneratzea arrakastaz hasi da
400
Bad Request - Server is not in a valid state for restoration
401
Baimenik gabea - Autentifikazio-token baliogabea edo falta da
404
Ez da aurkitu - Argazkia ez da existitzen
Abisua: 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.
Ezabatu argazkia
Ezabatu argazki bat betiko. Ekintza hau ezin da desegin.
Bidearen parametroak
Parametroa
Mota
Beharrezkoa
Deskribapena
snapshot_id
integer
Bai
Argazki-irudiaren ID bakarra
Eskaera adibidea
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
Erantzun Egoera Kodeak
204
Argazkia behar bezala ezabatu da
401
Baimenik gabea - Autentifikazio-token baliogabea edo falta da
404
Ez da aurkitu - Argazkia ez da existitzen
Snapshots vs Backups
Understanding when to use snapshots versus backups:
Argazkien APIa
Helburua: Quick point-in-time recovery
Abiadura: Faster to create and restore (3-15 min)
Erabilera kasua: Before risky operations (updates, config changes)
Biltegiratzea: Stored on same infrastructure
Muga: 5 snapshots per server
Onena honetarako: Short-term rollback capability
Babeskopien APIa
Helburua: Long-term data protection
Abiadura: Slower to create and restore (varies)
Erabilera kasua: Regular automated data protection
Biltegiratzea: Separate backup storage
Muga: 10 manual + automatic backups
Onena honetarako: 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