VPS.org API

Pagina officialis Documentationis

API Imaginum Temporalium

In hoc modo, scripturae scriptae sunt, et non plus inscriptae, et non plus inscriptae.

Extrema 4
Via Basis /api/v1/snapshots
ACQUIRE /api/v1/snapshots/

Omnes Imagines Enumera

Incolae, qui in urbe habitabant, in 25 familias divisae sunt.

Permissio necesse: snapshots:list

Exemplum Petitionis

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

Exemplum Responsionis

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

Campi Responsorum

Campo Typus Descriptio
uuid string Identifier (32 caracteres hexadecimali, non hic)
label string Etiam inscriptum cum aequatione creata est
server_hostname string Nomen host servitorii ex quo instantia facta est, vel nullum si servitor non plus existimat
ready boolean Verum cum instantia finita est
deleting boolean Verum cum eliminatio in progresso sit
created_at datetime Tempore UTC (ISO 8601)
size_gb number Magnitudo compressa in gigabytes
ACQUIRE /api/v1/snapshots/{uuid}/

Obtinuit aetate

Retortit unicum instantiae obiectum cum campis supra. Utitur ut post instantiam creandam prontae esse.

curl -X GET "https://admin.vps.org/api/v1/snapshots/3f9a1c0e5b7d4e2f8a6c1b3d5e7f9a0b/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
Post /api/v1/servers/{uuid}/snapshot/

Creare instantiam

Inquetur instantia servitorii deployatae et uuid novae instantiae restituit. Instantia imediate listatur cum ready in false positum.

Permissio necesse: servers:snapshot

Parametri Corporis Petitionis

Parametrus Typus Requisitum Descriptio
action string Ita Deinde incolae Aetate
snapshot_label string Ita Etichetta quae instantiam per ea reconocere potest
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"])

Exemplum Responsionis

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

Codices Status Responsorum

200 Actus in columnam inscriptus est
400 action or snapshot_label absent, or the server is not yet deployed
402 Non est methodus pagati in archivio, aut facturae non pagatae
404 Non repertus, aut ad alium contum pertinet
DELE /api/v1/snapshots/{uuid}/

Eliminare instantiam

Incolae, qui in urbem remanent, ad finem anni in urbem remanunt.

Permissio necesse: snapshots:delete

curl -X DELETE "https://admin.vps.org/api/v1/snapshots/3f9a1c0e5b7d4e2f8a6c1b3d5e7f9a0b/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "message": "Snapshot deletion queued"
}

Codices Status Responsorum

202 Acceptatus: petitio in columnam inscripta est
404 Non repertus, aut ad alium contum pertinet

Notiones