Argazki guztiak zerrendatu
Eskuratu zure zerbitzarietako argazki guztien zerrenda.
Kontsulta-parametroak
Parametroak
Mota
Beharrezkoa
Azalpena
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"
Kopiatu
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())
Kopiatu
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);
Kopiatu
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
Sortu zerbitzari baten uneko egoeraren argazki bat. Argazkiak zerbitzari osoaren denbora-puntuko kopiak dira.
Eskaeraren Gorputzaren Parametroak
Parametroak
Mota
Beharrezkoa
Azalpena
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"
}'
Kopiatu
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())
Kopiatu
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);
Kopiatu
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
Leheneratu zerbitzari bat argazki batean harrapatutako egoerara. Honek zerbitzarian dauden uneko datu guztiak gainidatziko ditu.
Bidearen parametroak
Parametroak
Mota
Beharrezkoa
Azalpena
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"
Kopiatu
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())
Kopiatu
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);
Kopiatu
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
Parametroak
Mota
Beharrezkoa
Azalpena
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"
Kopiatu
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)
Kopiatu
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
Noiz erabili snapshotak eta noiz babeskopiak:
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
Jardunbide egokiak
Eguneratu aurretik: Sortu argazki bat sistemaren eguneratze garrantzitsuen aurretik
Proba: Erabili argazkiak konfigurazio aldaketak probatzean
Estrategia konbinatua: Erabili bai argazkiak (epe laburrean) bai babeskopiak (epe luzean)
Garbitu: Ezabatu argazki zaharrak eguneraketak ongi egin ondoren
Zerbitzariaren egoera: Kontsideratu zerbitzaria gelditzea argazki kritikoak sortu aurretik