VPS.org API

ಪರೀಕ್ಷಕ API ದಸ್ತಾವೇಜೀಕರಣQuery

ಬ್ಯಾಕಪ್‌ಗಳ API

ನಿಮ್ಮ ಪರಿಚಾರಕದ (server) ಹಿನ್ನಲೆಗಳನ್ನು ಪಟ್ಟಿಮಾಡಿ, ಒಂದು ಹೊಸ ಪೂರೈಕೆದಾರನನ್ನು ಆರಂಭಿಸಿ, ಒಂದು ಪರಿಚಾರಕದಿಂದ ಒಂದು ಪರಿಚಾರಕವನ್ನು ಮರಳಿ ಸ್ಥಾಪಿಸಿ.

ಅಂತ್ಯಬಿಂದುಗಳು 4
ಬೇಸ್ ಪಾತ್ /api/v1/backups
ಪಡೆಯಿರಿ /api/v1/backups/

ಎಲ್ಲಾ ಬ್ಯಾಕಪ್‌ಗಳನ್ನು ಪಟ್ಟಿ ಮಾಡಿ

ಎಲ್ಲಾ ಪರಿಚಾರಕಗಳ ಬ್ಯಾಕೆಂಡ್ ಅನ್ನು ಮೊದಲು, ಅತಿ ಹೊಸದು, ಪುಟಕ್ಕೆ 25 ಅನ್ನು ಮರಳಿಸುತ್ತದೆ. ಸರ್ವರ್ ಶೋಧಕವಿಲ್ಲ: ಪರಿಚಾರಕ_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 ಪರಿಚಾರಕದ (server) ಆತಿಥೇಯ (host) ಪೂರೈಕೆದಾರ (host) ವುದೆ (ಕಾನ್)
name string ಕಡತ ಕಡತದ ಹೆಸರು
size_gb number Webiits ನಲ್ಲಿ ಸಂಕುಚಿತ ಗಾತ್ರ
deletion_date datetime ಈ ಪೂರೈಕೆದಾರನನ್ನು ಸ್ವಯಂಚಾಲಿತವಾಗಿ ತೆಗೆದು ಹಾಕಿದಾಗ@ info
days_remaining integer ದಿನಾಂಕವನ್ನು ತಲುಪಿಸುವವರೆಗೂ ಪೂರ್ಣరోజుಗಳು ಉಳಿದಿವೆ (_D)date the family
created_at datetime Creation time (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/

ಒಂದು ಕಾಪಿ ಮಾಡುವಿಕೆಯನ್ನು ರಚಿಸು

ಸಂಸ್ಕರಿಸಲಾದ ಪರಿಚಾರಕದ (server) ಒಂದು ಜಾಡನ್ನು (ಲಾಕಿಂಗ್) ಕ್ರಮದಲ್ಲಿ ಇಡುತ್ತದೆ. ಯಾವುದೇ ಬೇಡಿಕೆಯ ದೇಹವು ಬೇಕಿಲ್ಲ. ಅದನ್ನು ಮುಗಿಸಿದ ನಂತರ ಜಾಡು ಇರಿಸುವಿಕೆಯು ಕಾಣಿಸಿಕೊಳ್ಳುತ್ತದೆ, ಇದರಿಂದ ಡಿಸ್ಕಿನ ಬಳಕೆಯನ್ನು ಅಂಗೀಕರಿಸಲು ಹಲವಾರು ನಿಮಿಷ ತೆಗೆದುಕೊಳ್ಳುತ್ತದೆ.

ಅನುಮತಿಯ ಅಗತ್ಯವಿದೆ: 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 The action was queued
400 ಪರಿಚಾರಕ ಇನ್ನೂ ಸಹ ಹೊರಕ್ಕೆ ಹೋಗಲಿಲ್ಲ
402 ಕಡತದಲ್ಲಿ ಯಾವುದೇ ಹಣಕಾಸು ವಿಧಾನವಿಲ್ಲ, ಅಥವಾ facts ನಲ್ಲಿ ಯಾವುದೇ ಬೆಂಬಲವಿಲ್ಲ
404 ಕಂಡು ಬಂದಿಲ್ಲ, ಅಥವಾ ಅದು ಬೇರೊಂದು ಖಾತೆಗೆ ಸೇರಿದ್ದಾಗಿದೆ
ಪೋಸ್ಟ್ /api/v1/backups/{id}/restore/

ಒಂದು ದೋಷ ನಿವಾರಕದಿಂದ ಒಂದು ಪರಿಚಾರಕವನ್ನು ಮರಳಿ ಸ್ಥಾಪಿಸಿ

ಪರಿಚಾರಕದ (server) ತೆಗೆದು ಹಾಕಲಾದ ಮುದ್ರಿಕೆಯನ್ನು ನಿಲ್ಲಿಸುತ್ತದೆ, ಹಾಗು ಅದನ್ನು ಬ್ಯಾಕ್‌ಡೇಟ್‌ನೊಂದಿಗೆ ಮರಳಿ ಬರೆಯುತ್ತದೆ. ಯಾವ ಬೇಡಿಕೆಯೂ ದೇಹಕ್ಕೂ ಅಗತ್ಯವಾಗುವುದಿಲ್ಲ. ಮರಳಿ ಸ್ಥಾಪಿಸುವಾಗ ಪರಿಚಾರಕದ ಸ್ಥಿತಿ ಕ್ರಮಗೊಳಿಸಲ್ಪಡುತ್ತದೆ.

ಅನುಮತಿಯ ಅಗತ್ಯವಿದೆ: 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 The action was queued
400 ಪರಿಚಾರಕ ಇನ್ನೂ ಸಹ ಹೊರಕ್ಕೆ ಹೋಗಲಿಲ್ಲ
404 ಕಂಡು ಬಂದಿಲ್ಲ, ಅಥವಾ ಅದು ಬೇರೊಂದು ಖಾತೆಗೆ ಸೇರಿದ್ದಾಗಿದೆ

Notes