API Àfikún

GBÀ /api/v1/backups/

Ṣe àkójọ gbogbo àwọn àfikún

Fi àwọn àìpamọ́ àwọn sáà rẹ pamọ́ síì, tí ò tílẹ̀, 25 fún ojú-ìwé kan. Kò ní àwọn ààtò àtòjọ-ẹ̀yàn sáà: lò àwọn àtòjọ-ẹ̀yàn_àtòjọ-ìwé láti fi pamọ́.

Àwọn ìkúndùǹ tí a fẹ́: backups:list

Àwọn Ìbéèrè Pàtàkì

Àwọn Àtòjọ-ẹ̀yàn	Irú	Ti a nilo	Àwọn Àkọlé
`page`	integer	_Kò	Page number, starting at 1

Àpẹẹrẹ Ìbéèrè

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

Àpẹẹrẹ Ìdáhùn

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

Àwọn Ààyè Ìdáhùn

Àwọn Ààyè-iṣẹ́	Irú	Àwọn Àkọlé
`id`	integer	Àtòjọ-ẹ̀yàn ìṣàfarawé ìṣàmúlò-ètò, tí a lò láti gba àti ìṣàfarawé àwọn ààtò ìparí
`server_hostname`	string	Orúkọ́ àwọn ààtòjútó tí a tí ìṣàmúlò-ètò náà gbà
`name`	string	Orúkọ fáìlì àwọn àyọkà ìpamọ́
`size_gb`	number	Ìwọ̀n àwọn ààyè-iṣẹ́ nínú gigabaiti
`deletion_date`	datetime	Tí a bá yọ àìpamọ́ láti inú ìṣàmúlò-ètò náà
`days_remaining`	integer	Àwọn ọjọ́ ìtàn tí wọ́n tì kù lọ́wọ́lọ́wọ́ sí ọjọ́ ìdájọ́
`created_at`	datetime	Creation time (ISO 8601, UTC)

Àwọn Kóòdù Ipò Ìdáhùn

200	Àtòjọ àìpamọ́ àìtò
403	Tokénà API tí kò bá jẹ́ tàbí tí kò bá jẹ́, tàbí tokénà náà kò ní ìṣẹ̀dà tí a fẹ́

GBÀ /api/v1/backups/{id}/

Gba àwọn àyọkà ìpamọ́

Fi àwọn ààtò àìpamọ́ àti àwọn ààyè-iṣẹ́ inú padà sípò.

curl -X GET "https://admin.vps.org/api/v1/backups/5512/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Àwọn Àkọlé /api/v1/servers/{uuid}/backup/

Ṣẹ̀dà Àwọn Àmì-ìwé

Fi àwọn ààtò àìpamọ́ síì tí a tí fi pamọ́ sí sáà. Kò ní àwọn ẹ̀yàn ìtàn tí a fẹ́. Àìpamọ́ náà ń fihan nínú àtòjọ náà látigbá tí a tí parí, tí ó lè gba àwọn ààtò àìpamọ́ láti sé àwọn iṣẹ́ disiki.

Àwọn ìkúndùǹ tí a fẹ́: 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())

Àpẹẹrẹ Ìdáhùn

{
  "message": "Backup queued successfully"
}

Àwọn Kóòdù Ipò Ìdáhùn

200	Àwọn ìṣàmúlò-ètò
400	Àwọn ààtòjútó àwọn ààtòjútó
402	Kò ní ìṣàmúlò-ètò pàtó fún ìṣàmúlò-ètò nínú fáìlì, tàbí àwọn fátìrì tí a kò pà
404	Kò rí, tàbí ò jẹ́ àwọn

Àwọn Àkọlé /api/v1/backups/{id}/restore/

Ṣàfikún Sáfíìlì Lẹ́tà Àìṣàmúlò-ètò Lẹ́tà

Tí a bá dá ààtòjọ-ìṣàmúlò-ètò láti inú àwọn ààtòjọ-ìṣàmúlò-ètò náà, àwọn ààtòjọ-ìṣàmúlò-ètò náà nípa àwọn ààtòjọ-ìṣàmúlò-ètò náà, àwọn ààtòjọ-ìṣàmúlò-ètò náà nípa àwọn ààtòjọ-ìṣàmúlò-ètò náà.

Àwọn ìkúndùǹ tí a fẹ́: 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"
}

Àìbàmúlò: Gbogbo àwọn àkọ́lé tí a kọ̀ sí sáà láti ìgbà tí a tí gba àìpamọ́ náà tí kù. Àkóónú ìṣàfarawé ìṣàfarawé kò lè dá.

Àwọn Kóòdù Ipò Ìdáhùn

200	Àwọn ìṣàmúlò-ètò
400	Àwọn ààtòjútó àwọn ààtòjútó
404	Kò rí, tàbí ò jẹ́ àwọn

Àwọn Àmì-ìwé

Àwọn àìpamọ́ àìpẹ̀ nípa ìṣàfarawé àwọn àyọkà ìpamọ́. Ka àwọn àyọkà_àjọ_pàtó àti àwọn_àjọ_a
API kò lè pàtó àwọn àìpamọ́.
Snapshots are a separate resource with their own endpoints and are not listed here. Àwọn fọ́tò ìfàsẹ́yìn API

VPS.org API

Ṣe àkójọ gbogbo àwọn àfikún

Àwọn Ìbéèrè Pàtàkì

Àpẹẹrẹ Ìbéèrè

Àpẹẹrẹ Ìdáhùn

Àwọn Ààyè Ìdáhùn

Àwọn Kóòdù Ipò Ìdáhùn

Gba àwọn àyọkà ìpamọ́

Ṣẹ̀dà Àwọn Àmì-ìwé

Àpẹẹrẹ Ìdáhùn

Àwọn Kóòdù Ipò Ìdáhùn

Ṣàfikún Sáfíìlì Lẹ́tà Àìṣàmúlò-ètò Lẹ́tà

Àwọn Kóòdù Ipò Ìdáhùn

Àwọn Àmì-ìwé