Бардык сүрөттөрдү тизмелөө
Серверлериңиздеги бардык сүрөттөрдүн тизмесин алыңыз.
Сурам параметрлери
Параметрлер
Түрү
Талап кылынат
Сүрөт
server_id
integer
Жок
Сервердин идентификатору боюнча сүрөттөрдү чыпкалоо
Үлгү суроо-талап
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
Ооба
Сүрөткө тартуу үчүн сервердин идентификатору
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'тон калыбына келтирүү
Серверди сүрөткө түшүрүү учурундагы абалга кайтаруу. Бул учурдагы сервердеги бардык маалыматтарды кайрадан жазып чыгарат.
Жол параметрлери
Параметрлер
Түрү
Талап кылынат
Сүрөт
snapshot_id
integer
Ооба
Уникалдуу сүрөттүн идентификатору
Үлгү суроо-талап
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
Ооба
Уникалдуу сүрөттүн идентификатору
Үлгү суроо-талап
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
Эң мыкты практика
Жаңылоодон мурун: Системанын негизги жаңыртууларынан мурун сүрөттү жаратуу
Текшерүү: Конфигурация өзгөрүүлөрүн текшерүүдө сүрөттөрдү колдонуу
Бириккен стратегия: Экөө тең колдонулат: сүрөт (кыска мөөнөттүү) жана резервдик көчүрмө (узак мөөнөттүү)
Тазалоо: Жаңылоо ийгиликтүү болгондон кийин эски сүрөттөрдү өчүрүү
Сервердин абалы: Критикалык сүрөттөрдү жаратуудан мурун серверди токтотуу керек