ټول سنیپ شاټونه لیست کړئ
ستاسو په سرورونو کې د ټولو سنیپ شاټونو لیست ترلاسه کړئ.
د پوښتنې پیرامیټرې
پېرامېټر
ډول
اړین دی
سپړاوی
server_id
integer
نه
د سرور ID له مخې سنیپ شاټونه فلټر کړئ
د غوښتنې بېلګه
curl -X GET "https://admin.vps.org/api/v1/snapshots/?server_id=12345" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"
لمېسل_
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())
لمېسل_
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);
لمېسل_
د ځواب بېلګه
{
"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"
}
]
}
د غبرګون حالت کوډونه
200
د سنیپ شاټ لیست په بریالیتوب سره ترلاسه شو
401
غیر مجاز - د تصدیق نښه ناسمه یا ورکه ده
سنیپ شاټ جوړ کړئ
د پالنګر د اوسني حالت يو انځور جوړ کړئ. انځورونه د ټول پالنګر د وخت په ټکي کې لمېسې دي.
د بدن پیرامیټرو غوښتنه وکړئ
پېرامېټر
ډول
اړین دی
سپړاوی
server_id
integer
هو
د سنیپ شاټ لپاره د سرور ID
name
string
هو
د سنیپ شاټ نوم (الفانومریک، هایفنز، انډر سکور)
description
string
نه
د سنیپ شاټ لپاره اختیاري توضیحات
د غوښتنې بېلګه
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"
}'
لمېسل_
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())
لمېسل_
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);
لمېسل_
د ځواب بېلګه
{
"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."
}
د غبرګون حالت کوډونه
201
د سنیپ شاټ جوړول په بریالیتوب سره پیل شول
400
Bad Request - Invalid parameters or snapshot limit reached
401
غیر مجاز - د تصدیق نښه ناسمه یا ورکه ده
404
Not Found - Server does not exist
: يادښت 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_id
integer
هو
د سنیپ شاټ ځانګړی ID
د غوښتنې بېلګه
curl -X POST "https://admin.vps.org/api/v1/snapshots/801/restore/" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"
لمېسل_
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())
لمېسل_
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);
لمېسل_
د ځواب بېلګه
{
"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"
}
}
د غبرګون حالت کوډونه
200
بیا رغونه په بریالیتوب سره پیل شوه
400
Bad Request - Server is not in a valid state for restoration
401
غیر مجاز - د تصدیق نښه ناسمه یا ورکه ده
404
ونه موندل شو - سنیپ شاټ شتون نلري
خبرداری: 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.
سنیپ شاټ ړنګ کړئ
یو سنیپ شاټ په دایمي ډول ړنګ کړئ. دا عمل بیرته نشي راوستل کیدی.
د لارې پیرامیټرې
پېرامېټر
ډول
اړین دی
سپړاوی
snapshot_id
integer
هو
د سنیپ شاټ ځانګړی ID
د غوښتنې بېلګه
curl -X DELETE "https://admin.vps.org/api/v1/snapshots/801/" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"
لمېسل_
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)
لمېسل_
د غبرګون حالت کوډونه
204
سنیپ شاټ په بریالیتوب سره ړنګ شو
401
غیر مجاز - د تصدیق نښه ناسمه یا ورکه ده
404
ونه موندل شو - سنیپ شاټ شتون نلري
Snapshots vs Backups
پوهیدل کله چې د عکسونو پر وړاندې د عکسونو کارولو لپاره:
سنیپ شاټونه API
موخه: Quick point-in-time recovery
سرعت: Faster to create and restore (3-15 min)
د کارولو قضیه: Before risky operations (updates, config changes)
ذخیره کول: Stored on same infrastructure
:منځنۍ 5 snapshots per server
غوره د: Short-term rollback capability
د بیک اپ API
موخه: Long-term data protection
سرعت: Slower to create and restore (varies)
د کارولو قضیه: Regular automated data protection
ذخیره کول: Separate backup storage
:منځنۍ 10 manual + automatic backups
غوره د: Disaster recovery and compliance
غوره کړنې
:د اوسمهالولو نه مخکې د غونډال د لويو اوسمهالونو نه مخکې يو انځورن جوړول
ازموېنه: د سازونې بدلونونو د ازموېلو پر مهال انځورنونه کارول
ګډه ستراتيژي: دواړه سناپ شاټونه (لنډمهاله) او شاتړ (لنډمهاله) وکاروئ
: پاکول د بریالي اوسمهالولو نه وروسته زاړه انځورنونه ړنګول
:پالنګر انکړ د اړينو انځورونو د جوړولو نه مخکې د پالنګر ودرول په پام کې ونيسئ