VPS.org API

REST API ਡੌਕੂਮੈਂਟੇਸ਼ਨ

ਸਨੈਪਸ਼ਾਟ API

ਸਰਵਰ ਦਾ ਲੇਬਲ ਕੀਤਾ ਸਨੈਪਸ਼ਾਟ ਲਵੋ, ਉਨ੍ਹਾਂ ਦੀ ਲਿਸਟ ਬਣਾਓ ਅਤੇ ਉਹਨਾਂ ਨੂੰ ਹਟਾਓ, ਜਿਨ੍ਹਾਂ ਦੀ ਤੁਹਾਨੂੰ ਲੋੜ ਨਹੀਂ ਹੈ ।

ਅੰਤਮ ਬਿੰਦੂ 4
ਬੇਸ ਪਾਥ /api/v1/snapshots
ਪ੍ਰਾਪਤ ਕਰੋ /api/v1/snapshots/

ਸਾਰੇ ਸਨੈਪਸ਼ਾਟ ਸੂਚੀਬੱਧ ਕਰੋ

ਤੁਹਾਡੇ ਅਕਾਊਂਟ ਵਿੱਚ ਸਨੈਪਸ਼ਾਂਟ, ਨਵਾਂ ਪਹਿਲਾਂ, ਪ੍ਰਤੀ ਪੇਜ਼ ੨੫ ਮੁੜ- ਪ੍ਰਾਪਤ ਕਰੋ ।

ਲੋੜੀਦੇ ਅਧਿਕਾਰ: 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, UTC)
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/

ਇੱਕ ਸਨੈਪਸ਼ਾਂਟ ਬਣਾਓ

ਇੱਕ ਡਿਪੋਜ਼ਿਟ ਸਰਵਰ ਦਾ ਸਨੈਪਸ਼ਾਟ ਕਤਾਰ ਵਿੱਚ ਰੱਖੋ ਅਤੇ ਨਵੇਂ ਸਨੈਪਸ਼ਾਟ ਦਾ 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 ਐਕਸ਼ਨ ਕਤਾਰ ਵਿੱਚ ਹੈ
400 ਕਾਰਵਾਈ ਜਾਂ ਸੈਂਪਸ਼ਾਟ_ ਲੇਬਲ ਗੁੰਮ ਹੈ, ਜਾਂ ਸਰਵਰ ਹਾਲੇ ਡਿਪੋਰਟ ਨਹੀਂ ਕੀਤਾ ਗਿਆ ਹੈ
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 ਮਨਜ਼ੂਰ: ਬੇਨਤੀ ਕਤਾਰ ਵਿੱਚ ਹੈ
404 ਨਹੀਂ ਲੱਭਿਆ ਜਾਂ ਇਹ ਹੋਰ ਅਕਾਊਂਟ ਨਾਲ ਸਬੰਧਤ ਹੈ

ਨੋਟਿਸ