स्नैपशॉट एपीआई

सभी स्नैपशॉट सूचीबद्ध करें

अपने सभी सर्वरों पर मौजूद सभी स्नैपशॉट की सूची प्राप्त करें।

क्वेरी पैरामीटर

उदाहरण अनुरोध

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

स्नेपशॉट का उपयोग करते समय समझ:

बढ़िया अभ्यास

• अद्यतन से पहले: मुख्य तंत्र अद्यतन से पहले स्नेपशॉट बनाएं
• जांच किया जा रहा है: विन्यास परिवर्तनों को जाँचने के दौरान स्नेपशॉट इस्तेमाल करें
• मिश्रित कौशल: स्नैपशॉट तथा बैकअप दोनों स्नेपशॉट्स इस्तेमाल करें (अष्टि) (l)
• साफ: सफलता पूर्वक अद्यतन करने के बाद पुराने स्नेपशॉट को मिटाएँ
• सर्वर स्थिति: महत्वपूर्ण स्नेपशॉट बनाने से पहले सर्वर को रोके रखें