VPS.org API

REST API मिसिलीकरण

स्न्यापसट API

सर्भरको लेबुल गरिएको स्न्यापसट लिनुहोस्, तिनीहरूलाई सूचीबद्ध गर्नुहोस् र तपाईँलाई अब आवश्यक नभएकाहरू मेट्नुहोस् ।

अन्तिम बिन्दुहरू 4
आधार मार्ग /api/v1/snapshots
प्राप्त गर्नुहोस् /api/v1/snapshots/

सबै स्न्यापसटहरू सूचीबद्ध गर्नुहोस्

तपाईँको खातामा स्न्यापसटहरू, नयाँ पहिलो, प्रति पृष्ठ २५ फर्काउँछ ।

अनुमति आवश्यक: snapshots:list

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

cURL
Python
JavaScript
curl -X GET "https://admin.vps.org/api/v1/snapshots/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
import requests

url = "https://admin.vps.org/api/v1/snapshots/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.get(url, headers=headers)
for snapshot in response.json()["results"]:
    print(snapshot["uuid"], snapshot["label"], snapshot["ready"])
const response = await fetch('https://admin.vps.org/api/v1/snapshots/', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
});

const data = await response.json();
console.log(data.results);

उदाहरण प्रतिक्रिया

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "3f9a1c0e5b7d4e2f8a6c1b3d5e7f9a0b",
      "label": "before-upgrade",
      "server_hostname": "web-01",
      "ready": true,
      "deleting": false,
      "created_at": "2026-09-14T18:30:00.000000Z",
      "size_gb": 3.4
    }
  ]
}

प्रतिक्रिया क्षेत्रहरू

फिल्ड प्रकारहरू वर्णन
uuid string स्न्यापसट पहिचानकर्ता (३२ हेक्साडेसिमल क्यारेक्टर, हाइफन छैन)
label string स्न्यापसट सिर्जना गरिएको बेलामा दिएको लेबुल
server_hostname string सर्भरको होस्टनाम जसबाट स्न्यापसट लिइएको थियो, वा यदि सर्भर अब अवस्थित छैन भने शून्य
ready boolean स्न्यापसट समाप्त भएपछि ठीक
deleting boolean मेट्ने प्रक्रियामा हुँदा ठीक
created_at datetime सिर्जना समय (ISO 8601, UTC)
size_gb number गिगाबाइटमा सङ्कुचित साइज
प्राप्त गर्नुहोस् /api/v1/snapshots/{uuid}/

स्न्यापसट प्राप्त गर्नुहोस्

माथिको फिल्डसँग एउटा स्न्यापसट वस्तु फर्काउँछ । स्न्यापसट सिर्जना गरेपछि पोल तयार गर्न यसलाई प्रयोग गर्नुहोस् ।

curl -X GET "https://admin.vps.org/api/v1/snapshots/3f9a1c0e5b7d4e2f8a6c1b3d5e7f9a0b/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
पोस्ट /api/v1/servers/{uuid}/snapshot/

स्न्यापसट सिर्जना गर्नुहोस्

सर्भरको स्न्यापसट लामबद्ध गर्दछ र नयाँ स्न्यापसटको uuid फर्काउँछ । स्न्यापसटलाई गलत सेट गर्न तयारसँग त्यहिँ सूचीकृत गरिन्छ ।

अनुमति आवश्यक: servers:snapshot

अनुरोध बडी प्यारामिटरहरू

परिमिति प्रकारहरू आवश्यक छ वर्णन
action string हो स्न्यापसट हुनुपर्दछ
snapshot_label string हो यसद्वारा स्न्यापसट पहिचान गर्न लेबुल
cURL
Python
curl -X POST "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/snapshot/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "snapshot", "snapshot_label": "before-upgrade"}'
import requests

server_uuid = "8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b"
url = f"https://admin.vps.org/api/v1/servers/{server_uuid}/snapshot/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}
data = {"action": "snapshot", "snapshot_label": "before-upgrade"}

response = requests.post(url, headers=headers, json=data)
print(response.json()["snapshot_uuid"])

उदाहरण प्रतिक्रिया

{
  "message": "Snapshot queued successfully",
  "snapshot_uuid": "3f9a1c0e5b7d4e2f8a6c1b3d5e7f9a0b"
}

प्रतिक्रिया स्थिति कोडहरू

200 कार्य लाम लगाइएको थियो
400 कार्य वा स्न्यापसट लेबुल हराइरहेको छ, वा सर्भर अझै पनि तैनात गरिएको छैन
402 फाइलमा कुनै भुक्तानी विधि छैन, वा भुक्तानी नगरिएका बिलहरू
404 फेला परेन, वा यो अर्को खातासँग सम्बन्धित छ
मेटाउनुहोस् /api/v1/snapshots/{uuid}/

स्न्यापसट मेट्नुहोस्

स्थायी मेट्नका लागि स्न्यापसटलाई लाम लगाउँछ । मेट्ने यो गएको सम्म ठीक छ ।

अनुमति आवश्यक: snapshots:delete

curl -X DELETE "https://admin.vps.org/api/v1/snapshots/3f9a1c0e5b7d4e2f8a6c1b3d5e7f9a0b/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "message": "Snapshot deletion queued"
}

प्रतिक्रिया स्थिति कोडहरू

202 स्वीकृत: अनुरोध लाम लगाइएको थियो
404 फेला परेन, वा यो अर्को खातासँग सम्बन्धित छ

द्रष्टब्य