VPS.org API

టెక్స్టు API పత్రికీకరణQuery

స్నాప్‌షాట్‌ల 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 స్నాప్ హాట్ గుర్తింపు( 32xcellicలు, ఏ హిప్టెన్లు లేవు)
label string స్కోప్‌ను సృష్టించినప్పటికే లేబుల్ ఇచ్చింది
server_hostname string సెర్వర్ ఇకపై అందుబాటులో లేకపోతే సెర్వర్డ్ యొక్క హోస్ట్ నిక్‌ప్యాస్‌నుంచి తొలగించబడింది లేదా తొలగించబడింది
ready boolean నిజం చైల్డ్ పూర్తైనది
deleting boolean నిజమే, కోడ్ క్రియాశీలంగా ఉన్నప్పుడే
created_at datetime సృష్టి సమయం (ఐఎస్ ఓ 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/

స్నాప్‌కాట్‌ను సృష్టించుము

ఒక సిస్టం అయిన సెర్వర్ యొక్క స్క్రాల్‌పాన్స్‌ను క్రమముచేస్తుంది మరియు కొత్త స్పెల్‌బార్ 'u' 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 చర్య క్రమాంతరంగా వుందిQNativeSocketEngine
400 చర్య లేదా స్క్రాల్‌జాండ్ (_t), లేదా సేవిక ఇంకా పంపబడలేదు
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 అంగీకరించబడిన: మనవి క్రమాంతరీకరణం చేయబడిందిQNativeSocketEngine
404 దొరకలేదు, లేక మరొక ఖాతాకి చెందినది అదిలేదు

వ్యాఖ్యలు