VPS.org API

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

బ్యాకప్‌ల API

మీ సెర్వర్ బ్యాక్అప్లను జాబితాగాచూపు, కొత్త బ్యాక్అప్ను ప్రారంభించు మరియు ఒక సెర్వర్ నుండి ఒక తిరిగివుంచుము.

అంత్య బిందువులు 4
బేస్ పాత్ /api/v1/backups
పొందండి /api/v1/backups/

అన్ని బ్యాకప్‌లను జాబితా చేయి

మీ సెర్వర్ల అన్ని బ్యాకప్లను తిరిగివుంచుము, మొదటిది, నికొత్తమైనది, 25 ను తరువాతిదిగుము. ఏ సేవిక ఫిల్టర్ లేదు: సెర్వర్_ హోస్టు పేరును వుపయోగించి వాటిని సమూహానికి బదిలీ చేయుము.

అనుమతించు: backups:list

ప్రశ్న పారామితులు

పెరామీటరు రకం అవసరం విశదీకరణము
page integer వద్దు పుట సంఖ్య, 1 నుంచి ప్రారంభము

ఉదాహరణ అభ్యర్థన

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

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

response = requests.get(url, headers=headers)
for backup in response.json()["results"]:
    print(backup["id"], backup["server_hostname"], backup["created_at"])
const response = await fetch('https://admin.vps.org/api/v1/backups/', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
});

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

ఉదాహరణ ప్రతిస్పందన

{
  "count": 96,
  "next": "https://admin.vps.org/api/v1/backups/?page=2",
  "previous": null,
  "results": [
    {
      "id": 5512,
      "server_hostname": "web-01",
      "name": "vzdump-qemu-1042-2026_09_14-16_44_10.vma.zst",
      "size_gb": 3.12,
      "deletion_date": "2026-09-21T20:45:40.697512Z",
      "days_remaining": 6,
      "created_at": "2026-09-14T20:45:40.699494Z"
    }
  ]
}

ప్రతిస్పందన ఫీల్డ్‌లు

క్షేత్రము రకం విశదీకరణము
id integer తేలుకొని చివరి పాయింట్లు వాడుకునే బ్యాక్అప్ గుర్తింపుదారి
server_hostname string సెర్వర్ యొక్క హోస్ట్ బ్యాక్అప్ను స్వీకరించబడింది
name string బ్యాక్అప్ ఆర్చివ్ ఫైల్ పేరు
size_gb number గ్లాసబాటులనందు కుదించబడిన పరిమాణము
deletion_date datetime బ్యాక్అప్ స్వయంచాలకంగా తీసినప్పుడు
days_remaining integer తేదీని పూర్తైనది(_D)date the this empties
created_at datetime సృష్టి సమయం (ఐఎస్ ఓ 8601, యు డి ఐ)

ప్రతిస్పందన స్థితి కోడ్‌లు

200 బ్యాక్అప్ జాబితా సమర్ధవంతంగా వెలికితీయబడింది
403 చెల్లని API గుర్తు లేదా అవసరమైన సూచనకు లేదా గుర్తించవలసిన అనుమతి లేదు
పొందండి /api/v1/backups/{id}/

ఒక బ్యాక్అప్ని పొందుము

ఒక బ్యాక్అప్ వస్తువు పైన ఫీల్డ్లతో తిరిగివుంచుతుంది.

curl -X GET "https://admin.vps.org/api/v1/backups/5512/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
పెరా /api/v1/servers/{uuid}/backup/

బ్యాక్అప్ సృష్టించండి

సంక్షిష్ట సేవిక యొక్క బ్యాక్అప్ నిర్దించబడుతోంది. ఏ అభ్యర్ధన శవస్థ అవసరంలేదు. అది పూర్తైన తర్వాత బ్యాక్అప్ కనబడుతుంది, దానితో డిస్క్ వినిమయం ఆధారంగా చాలా నిమిషాలు పడుతుంది.

అనుమతించు: servers:backup

cURL
Python
curl -X POST "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/backup/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
import requests

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

response = requests.post(url, headers=headers)
print(response.json())

ఉదాహరణ ప్రతిస్పందన

{
  "message": "Backup queued successfully"
}

ప్రతిస్పందన స్థితి కోడ్‌లు

200 చర్య క్రమాంతరంగా వుందిQNativeSocketEngine
400 సెర్వర్ ఇంకా సిద్దంచేయబడలేదు
402 ఫైలునందు ఏ చెల్లింపు పద్దతిలేదు, లేదా సమైక్యతలనందు సహాయంలేదు
404 దొరకలేదు, లేక మరొక ఖాతాకి చెందినది అదిలేదు
పెరా /api/v1/backups/{id}/restore/

బ్యాక్అప్ నుంచి సెర్వర్ను తిరిగివుంచుము

సేవిక యొక్క బ్యాక్అప్ తీయబడివుండగా, దానిని తిరిగివ్రాస్తుంది మరియు దానిని మళ్ళీ ప్రారంభించు. ఏ అభ్యర్ధన శరీరం అవసరం. తిరిగివ్రాయబడుతుంది అయితే సెర్వర్ స్థితి వరుసలో వుంది.

అనుమతించు: backups:restore

curl -X POST "https://admin.vps.org/api/v1/backups/5512/restore/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "message": "Backup restore queued. The server will be stopped, restored, and restarted.",
  "backup": "vzdump-qemu-1042-2026_09_14-16_44_10.vma.zst",
  "job_id": "b6f1c7e2-3a4d-4f5e-8b9c-0d1e2f3a4b5c"
}
హెచ్చరిక: బ్యాక్అప్ తొలగించిన తర్వాత సెర్వర్నకు వ్రాయిన ప్రతిదీ తిరిగివ్రాయలేము.

ప్రతిస్పందన స్థితి కోడ్‌లు

200 చర్య క్రమాంతరంగా వుందిQNativeSocketEngine
400 సెర్వర్ ఇంకా సిద్దంచేయబడలేదు
404 దొరకలేదు, లేక మరొక ఖాతాకి చెందినది అదిలేదు

వ్యాఖ్యలు