Bütün Anlık Görüntüləri Siyahıya Alın
Serverlərinizdəki bütün anlıq görüntülərin siyahısını əldə edin.
Sorğu Parametrləri
Parametrlər
Növü
Tələb olunur
İzahat
server_id
integer
_Yox
Anlıq görüntüləri server ID-sinə görə filtrləyin
Nümunə Sorğu
curl -X GET "https://admin.vps.org/api/v1/snapshots/?server_id=12345" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"
Köçür
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())
Köçür
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);
Köçür
Nümunə Cavab
{
"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"
}
]
}
Cavab Status Kodları
200
Snapshot siyahısı uğurla əldə edildi
401
İcazəsiz - Yanlış və ya çatışmayan identifikasiya nişanı
Anlıq görüntü yaradın
Vericinin hazırkı vəziyyətinin bir şəklini yarat. şəkillər bütün vericinin vaxt nöqtəsi nüsxələridir.
Əsas Parametrləri Sorğu
Parametrlər
Növü
Tələb olunur
İzahat
server_id
integer
Bəli
Snapshot üçün serverin ID-si
name
string
Bəli
Şəkilin adı (hərf-rəqəm, defis, alt xətt)
description
string
_Yox
Anlıq görüntü üçün əlavə təsvir
Nümunə Sorğu
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"
}'
Köçür
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())
Köçür
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);
Köçür
Nümunə Cavab
{
"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."
}
Cavab Status Kodları
201
Snapshot yaradılması uğurla başladı
400
Bad Request - Invalid parameters or snapshot limit reached
401
İcazəsiz - Yanlış və ya çatışmayan identifikasiya nişanı
404
Not Found - Server does not exist
Xatırlatma: 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.
Snapshot-dan bərpa edin
Vericini şəkildəki vəziyyətinə qaytar. Bu, vericidəki bütün hazırkı məlumatları üstə yazır.
Yol Parametrləri
Parametrlər
Növü
Tələb olunur
İzahat
snapshot_id
integer
Bəli
Unikal anlıq görüntü ID-si
Nümunə Sorğu
curl -X POST "https://admin.vps.org/api/v1/snapshots/801/restore/" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"
Köçür
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())
Köçür
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);
Köçür
Nümunə Cavab
{
"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"
}
}
Cavab Status Kodları
200
Bərpa uğurla başladı
400
Bad Request - Server is not in a valid state for restoration
401
İcazəsiz - Yanlış və ya çatışmayan identifikasiya nişanı
404
Tapılmadı - Anlıq görüntü mövcud deyil
Xəbərdarlıq: 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.
Anlıq görüntünü silin
Anlıq görüntünü birdəfəlik silin. Bu əməliyyat geri qaytarıla bilməz.
Yol Parametrləri
Parametrlər
Növü
Tələb olunur
İzahat
snapshot_id
integer
Bəli
Unikal anlıq görüntü ID-si
Nümunə Sorğu
curl -X DELETE "https://admin.vps.org/api/v1/snapshots/801/" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"
Köçür
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)
Köçür
Cavab Status Kodları
204
Snapshot uğurla silindi
401
İcazəsiz - Yanlış və ya çatışmayan identifikasiya nişanı
404
Tapılmadı - Anlıq görüntü mövcud deyil
Snapshots vs Backups
Növbəti səhifəyə keç
Anlıq görüntülər API-si
Məqsəd: Quick point-in-time recovery
Sürət: Faster to create and restore (3-15 min)
İstifadə halı: Before risky operations (updates, config changes)
Saxlama: Stored on same infrastructure
Sınır: 5 snapshots per server
Ən yaxşısı: Short-term rollback capability
Yedəkləmə API-si
Məqsəd: Long-term data protection
Sürət: Slower to create and restore (varies)
İstifadə halı: Regular automated data protection
Saxlama: Separate backup storage
Sınır: 10 manual + automatic backups
Ən yaxşısı: Disaster recovery and compliance
Ən Yaxşı Əməliyyatlar
Yeniləmələrdən əvvəl: Böyük sistem yeniləmələrindən əvvəl bir şəkil yarad
Test Quraşdırma dəyişikliklərini sınayarkən şəkilləri istifadə et
Birləşmiş Strateji: Hər iki şəkil (qısamüddətli) və zəng (uzunmüddətli) istifadə et
Təmizlə: Müvəffəqiyyətlə yeniləndikdən sonra köhnə şəkilləri sil
Verici Ölçüsü: Xətalı şəkillər yaratmazdan əvvəl vericinin dayandırılmasını düşünün