VPS.org API

REST API દસ્તાવેજીકરણ

બેકઅપ્સ API

તમારા સર્વર બેકઅપની યાદી કરો, નવું બેકઅપ શરૂ કરો અને સર્વરને એકમાંથી પુનઃસંગ્રહો.

અંતિમ બિંદુઓ 4
બેઝ પાથ /api/v1/backups
મેળવો /api/v1/backups/

બધા બેકઅપ્સની યાદી બનાવો

તમારા બધા સર્વરોના બેકઅપ પાછા આપે છે, નવી પહેલી, પાના દીઠ ૨૫. ત્યાં સર્વર ગાળક નથી: તેમને સમૂહ કરવા માટે server_hostname વાપરો.

જરૂરી પરવાનગી: backups:list

ક્વેરી પરિમાણો

પરિમાણો પ્રકાર જરૂરી વર્ણન
page integer નહિં પાનાં નંબર, ૧ થી શરૂ થાય છે

ઉદાહરણ વિનંતી

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)
created_at datetime બનાવટ સમય (ISO 8601, UTC)

પ્રતિભાવ સ્થિતિ કોડ્સ

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 ક્રિયા કતારમાં હતી
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 ક્રિયા કતારમાં હતી
400 સર્વર હજુ સુધી સ્થાપિત થયેલ નથી
404 મળ્યુ નથી, અથવા તે બીજા ખાતાને લગતુ છે

નોંધો