VPS.org API

डेटी एपीआई प्रलेख

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

सर्वर के लिए लेबल युक्तियाँ लें, उन्हें सूची और नष्ट करें जो आपको अब आवश्यकता नहीं है.

अंतिमबिंदुओं 4
आधार पथ /api/v1/snapshots
पाना /api/v1/snapshots/

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

स्नैपशॉट आपके खाते में वापस आता है, नया सबसे पहला, 25 प्रति पृष्ठ.

अनुमति: 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 आशुचित्र पहचानकर्ता (32 हेक्साडेसीमल अक्षर, कोई इपॉसीन नहीं)
label string जब स्नेपशॉट बनाया गया हो तो लेबल दें
server_hostname string सर्वर का होस्टनाम जो कि यह सर्वर से लिया गया था, या नल यदि वह अब मौजूद नहीं है
ready boolean एक बार स्नैपशॉट पूरा हो गया
deleting boolean सच है जबकि मिटाना प्रगति में है
created_at datetime सृष्टि समय (ISO 8601, यूटीसी)
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/

स्नेपशॉट बनाएं

डिफ़्ड सर्वर का स्नेपशॉटेस को बन्द करता है तथा नया स्नेपशॉट ududuPDYEPEARDEADDE. स्नैपशॉट को गलत सेट के साथ सीधे ही हटाया जाता है.

अनुमति: 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 action या snapshot_label गायब है, या server अभी डिप्लॉय नहीं हुआ है
402 फ़ाइल पर कोई भुगतान विधि, या scrats में
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 नहीं मिला, या यह अन्य खाता है

टिप्पणी