سنيپ شاٽس API

سڀ سنيپ شاٽ لسٽ ڪريو

پنهنجي سرورن تي سڀني سنيپ شاٽس جي هڪ فهرست حاصل ڪريو.

سوال جا پيرا ميٽر

مثال جي درخواست

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"
    }
  ]
}

جوابي اسٽيٽس ڪوڊس

سنيپ شاٽ ٺاهيو

سرور جي موجوده حالت جو هڪ سيٽ اپ ٺاهيو. سيٽ اپ پوريءَ سرور جو وقت جي نقطي تي نقل آهن.

درخواست باڊي پيرا ميٽرز

مثال جي درخواست

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."
}

جوابي اسٽيٽس ڪوڊس

سنيپ شاٽ مان بحال ڪريو

سرور کي ان حالت ۾ موٽائي آڻجو جنھن ۾ ان کي سيٽ ڪيو ويو آھي. ھي سرور تي سڀني موجوده ڊيٽا تي ٻيهر لکندو.

رستي جا پيرا ميٽر

مثال جي درخواست

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"
  }
}

جوابي اسٽيٽس ڪوڊس

سنيپ شاٽ ختم ڪريو

مستقل طور تي هڪ سنيپ شاٽ ختم ڪريو. هي عمل واپس نه ٿو ڪري سگهجي.

رستي جا پيرا ميٽر

مثال جي درخواست

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)

جوابي اسٽيٽس ڪوڊس

Snapshots vs Backups

سڃاڻپ ڪڏھن استعمال ڪجي سنپ شاٽز ۽ بڪ اپز جي وچ ۾:

بهترين طريقا

• اڀياس کان اڳ: وڏي نظام جي اپڊيٽ کان اڳ هڪ سيٽ اپ ٺاهيو
• آزمائش: ڪنٽرول تبديلين جي جانچ ڪرڻ وقت تصويرون استعمال ڪريو
• گڏيل حڪمت عملي: ٻنهي (ڪم وقت) ۽ (ڊگهي وقت) سڪون شاٽس استعمال ڪريو
• صاف ڪرڻ: ڪامياب اپڊيٽ کانپوءِ پراڻيون تصويرون حذف ڪريو
• سروس جي حالت: بحراني تصويرون ٺاهڻ کان اڳ سروس بند ڪرڻ تي غور ڪريو