API de sauvegarde

Liste de toutes les sauvegardes

Retourne les sauvegardes de tous vos serveurs, les plus récents en premier, 25 par page. Il n'y a pas de filtre serveur: utilisez server_hostname pour les regrouper.

Autorisation requise: backups:list

Paramètres de requête

Exemple de requête

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

Exemple de réponse

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

Champs de réponse

Codes d'état de réponse

Un sauvegarde

Retourne un objet de sauvegarde avec les champs ci-dessus.

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

Créer une sauvegarde

Requête une sauvegarde d'un serveur déployé. Aucun corps de requête n'est nécessaire. La sauvegarde apparaît dans la liste une fois qu'elle a fini, ce qui peut prendre plusieurs minutes en fonction de l'utilisation du disque.

Autorisation requise: servers:backup

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

Exemple de réponse

{
  "message": "Backup queued successfully"
}

Codes d'état de réponse

Restaurer un serveur depuis une sauvegarde

Arrête le serveur de la sauvegarde, écrase son disque avec la sauvegarde et le redémarre. Aucun corps de requête n'est nécessaire. L'état du serveur est en file d'attente pendant que la restauration est lancée.

Autorisation requise: 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"
}

Codes d'état de réponse

Annexe

• Les sauvegardes expirent automatiquement. Lisez delete_date ou days_remaining au lieu d'assumer une période de conservation.
• L'API ne peut pas supprimer une sauvegarde.
• Les instantanés sont une ressource distincte avec leurs propres paramètres et ne sont pas listés ici. API Snapshots