Mga Snapshot API

Ilista ang Lahat ng Snapshot

Bumalik ang mga snapshot sa iyong account, pinakabagong unang, 25 bawat pahina.

Kailangang pahintulot: snapshots:list

Halimbawang Kahilingan

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);

Halimbawang Tugon

{
  "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
    }
  ]
}

Mga Patlang ng Tugon

Kumuha ng isang snapshot

Bumalik ng isang snapshot bagay sa mga patlang sa itaas. Gamitin ito upang poll handa pagkatapos ng paglikha ng isang snapshot.

curl -X GET "https://admin.vps.org/api/v1/snapshots/3f9a1c0e5b7d4e2f8a6c1b3d5e7f9a0b/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Lumikha ng isang snapshot

Queues isang snapshot ng isang deployed server at bumalik ang bagong snapshot ng uuid. Ang snapshot ay nakalista agad na may handa na itakda sa false.

Kailangang pahintulot: servers:snapshot

Humiling ng mga Parameter ng Katawan

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"])

Halimbawang Tugon

{
  "message": "Snapshot queued successfully",
  "snapshot_uuid": "3f9a1c0e5b7d4e2f8a6c1b3d5e7f9a0b"
}

Mga Kodigo ng Katayuan ng Tugon

Mag-edit ng isang snapshot

Ang mga ito ay maaaring maging permanente o pansamantalang, depende sa kung ano ang nais mong gawin.

Kailangang pahintulot: snapshots:delete

curl -X DELETE "https://admin.vps.org/api/v1/snapshots/3f9a1c0e5b7d4e2f8a6c1b3d5e7f9a0b/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "message": "Snapshot deletion queued"
}

Mga Kodigo ng Katayuan ng Tugon

Mga tala

• Pagbawi ng isang snapshot ay hindi magagamit sa pamamagitan ng API. Gamitin ang control panel sa admin.vps.org.
• Para ibalik sa pamamagitan ng API, gamitin ang isang backup sa halip. Mga Backup API