Barcha suratlarni ro'yxatlash
Serverlaringizdagi barcha suratlar ro'yxatini oling.
So'rov parametrlari
Parameter
Turi
Majburiy
Description
server_id
integer
No
Server identifikatori bo'yicha suratlarni filtrlang
Namunaviy so'rov
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
Javob namunasi
{
"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"
}
]
}
Javob holati kodlari
200
Suratlar ro'yxati muvaffaqiyatli olindi
401
Tasdiqlanmagan - Autentifikatsiya tokeni noto'g'ri yoki yo'q
Surat yaratish
Create a snapshot of a server's current state. Snapshots are point-in-time copies of the entire server.
Tana parametrlarini so'rash
Parameter
Turi
Majburiy
Description
server_id
integer
Ha
Suratga olish uchun server identifikatori
name
string
Ha
Surat uchun nom (harf-raqamlar, defislar, pastki chiziqlar)
description
string
No
Surat uchun ixtiyoriy tavsif
Namunaviy so'rov
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
Javob namunasi
{
"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."
}
Javob holati kodlari
201
Surat yaratish muvaffaqiyatli boshlandi
400
Bad Request - Invalid parameters or snapshot limit reached
401
Tasdiqlanmagan - Autentifikatsiya tokeni noto'g'ri yoki yo'q
404
Not Found - Server does not exist
Note: 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.
Snapshotdan tiklash
Restore a server to the state captured in a snapshot. This will overwrite all current data on the server.
Yo'l parametrlari
Parameter
Turi
Majburiy
Description
snapshot_id
integer
Ha
Noyob surat identifikatori
Namunaviy so'rov
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
Javob namunasi
{
"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"
}
}
Javob holati kodlari
200
Tiklash muvaffaqiyatli boshlandi
400
Bad Request - Server is not in a valid state for restoration
401
Tasdiqlanmagan - Autentifikatsiya tokeni noto'g'ri yoki yo'q
404
Topilmadi - Surat mavjud emas
Ogohlantirish: 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.
Suratni o'chirish
Suratni butunlay o'chirish. Bu amalni bekor qilib bo'lmaydi.
Yo'l parametrlari
Parameter
Turi
Majburiy
Description
snapshot_id
integer
Ha
Noyob surat identifikatori
Namunaviy so'rov
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
Javob holati kodlari
204
Surat muvaffaqiyatli o'chirildi
401
Tasdiqlanmagan - Autentifikatsiya tokeni noto'g'ri yoki yo'q
404
Topilmadi - Surat mavjud emas
Snapshots vs Backups
Understanding when to use snapshots versus backups:
Snapshots API'si
Maqsad: Quick point-in-time recovery
Tezlik: Faster to create and restore (3-15 min)
Foydalanish holati: Before risky operations (updates, config changes)
Saqlash: Stored on same infrastructure
Limit: 5 snapshots per server
Eng yaxshisi: Short-term rollback capability
Zaxira nusxalari APIsi
Maqsad: Long-term data protection
Tezlik: Slower to create and restore (varies)
Foydalanish holati: Regular automated data protection
Saqlash: Separate backup storage
Limit: 10 manual + automatic backups
Eng yaxshisi: 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