VPS.org API

Antontan-taratasy momba ny REST API

API backups

Tantano amin'ny alalan'ny fandaharana ny backup an'ny mpizara. Tanisao, forony, avereno ary fafao ny backup ho an'ny mpizara anao.

Teboka farany 3 endpoints
Lalana fototra /api/v1/backups
ALAO /api/v1/backups/

Tanisao ny backup rehetra

Makà lisitry ny backup rehetra manerana ny mpizara anao.

Paramètres de requête

fikirana Karazana ilaina Description
server_id integer tsy misy Sivana ny backups araka ny ID mpizara
backup_type string tsy misy Sivana araka ny karazany: manual , automatic

Ohatra amin'ny fangatahana

cURL
Python
JavaScript
curl -X GET "https://admin.vps.org/api/v1/backups/?server_id=12345" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"
import requests

url = "https://admin.vps.org/api/v1/backups/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
params = {"server_id": 12345}

response = requests.get(url, headers=headers, params=params)
print(response.json())
const response = await fetch('https://admin.vps.org/api/v1/backups/?server_id=12345', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const backups = await response.json();
console.log(backups);

Ohatra amin'ny Valiny

{
  "count": 3,
  "results": [
    {
      "id": 501,
      "server": {
        "id": 12345,
        "name": "web-server-01"
      },
      "backup_type": "automatic",
      "status": "completed",
      "size_mb": 4523,
      "created_at": "2025-01-16T03:00:00Z",
      "expires_at": "2025-02-16T03:00:00Z",
      "description": "Automatic daily backup"
    },
    {
      "id": 499,
      "server": {
        "id": 12345,
        "name": "web-server-01"
      },
      "backup_type": "manual",
      "status": "completed",
      "size_mb": 4456,
      "created_at": "2025-01-14T10:30:00Z",
      "expires_at": null,
      "description": "Pre-update backup"
    },
    {
      "id": 495,
      "server": {
        "id": 12345,
        "name": "web-server-01"
      },
      "backup_type": "automatic",
      "status": "completed",
      "size_mb": 4389,
      "created_at": "2025-01-15T03:00:00Z",
      "expires_at": "2025-02-15T03:00:00Z",
      "description": "Automatic daily backup"
    }
  ]
}

Kaody momba ny satan'ny valiny

200 Voaray soa aman-tsara ny lisitry ny backup
401 Tsy nahazoana alalana - Tsy manan-kery na tsy ampy ny mari-pamantarana fanamarinana
POST /api/v1/backups/

Mamorona backup tanana

Mamoròna backup tanana ho an'ny mpizara. Tsy lany daty ho azy ny backup tanana.

Fangatahana masontsivana momba ny vatana

fikirana Karazana ilaina Description
server_id integer ENY ID an'ny mpizara hanaovana backup
description string tsy misy Famaritana azo isafidianana ho an'ny backup

Ohatra amin'ny fangatahana

cURL
Python
JavaScript
PHP
curl -X POST "https://admin.vps.org/api/v1/backups/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "server_id": 12345,
    "description": "Pre-deployment backup"
  }'
import requests

url = "https://admin.vps.org/api/v1/backups/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "server_id": 12345,
    "description": "Pre-deployment backup"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())
const response = await fetch('https://admin.vps.org/api/v1/backups/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    server_id: 12345,
    description: 'Pre-deployment backup'
  })
});

const backup = await response.json();
console.log(backup);
$data = [
    'server_id' => 12345,
    'description' => 'Pre-deployment backup'
];

$ch = curl_init('https://admin.vps.org/api/v1/backups/');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_TOKEN',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$backup = json_decode($response, true);
curl_close($ch);

Ohatra amin'ny Valiny

{
  "id": 502,
  "server": {
    "id": 12345,
    "name": "web-server-01"
  },
  "backup_type": "manual",
  "status": "in_progress",
  "size_mb": null,
  "created_at": "2025-01-16T15:45:00Z",
  "expires_at": null,
  "description": "Pre-deployment backup",
  "message": "Backup is being created. This may take several minutes depending on server size."
}

Kaody momba ny satan'ny valiny

201 Nanomboka soa aman-tsara ny famoronana backup
400 Fangatahana Ratsy - Paramètre tsy manan-kery na fangatahana tsy ara-dalàna
401 Tsy nahazoana alalana - Tsy manan-kery na tsy ampy ny mari-pamantarana fanamarinana
404 Tsy hita - Tsy misy ny mpizara
Fanamarihana: Afaka manana backup 10 isaky ny mpizara ianao. Ny backup mandeha ho azy dia tehirizina araka ny politikan'ny fitahirizana backup ao amin'ny drafitrao (matetika 7-30 andro).
Fafao /api/v1/backups/{backup_id}/

Fafao ny backup

Fafao tanteraka ny backup. Tsy azo foanana ity hetsika ity.

Masontsivana momba ny lalana

fikirana Karazana ilaina Description
backup_id integer ENY ID backup tokana

Ohatra amin'ny fangatahana

cURL
Python
JavaScript
curl -X DELETE "https://admin.vps.org/api/v1/backups/501/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"
import requests

backup_id = 501
url = f"https://admin.vps.org/api/v1/backups/{backup_id}/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.delete(url, headers=headers)
print(response.status_code)
const backupId = 501;
const response = await fetch(`https://admin.vps.org/api/v1/backups/${backupId}/`, {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

console.log(response.status);

Kaody momba ny satan'ny valiny

204 Voafafa soa aman-tsara ny backup
401 Tsy nahazoana alalana - Tsy manan-kery na tsy ampy ny mari-pamantarana fanamarinana
404 Tsy hita - Tsy misy ny backup
Fampitandremana: Maharitra ny famafana backup ary tsy azo averina intsony. Ataovy azo antoka fa tsy mila an'io backup io intsony ianao alohan'ny hamafana azy.

Famerenana amin'ny laoniny avy amin'ny Backups

Mba hamerenana amin'ny laoniny ny mpizara avy amin'ny backup, ampiasao ny Servers API restore endpoint:

POST /api/v1/servers/{server_id}/restore/
{
  "backup_id": 501
}

Raha mila fanazavana fanampiny momba ny famerenana amin'ny laoniny ny mpizara, jereo ny Antontan-taratasy momba ny API an'ny mpizara.

Fomba fanao tsara indrindra amin'ny backup