API de copias de seguridad

Listar todas las copias de seguridad

Devuelve las copias de seguridad de todos sus servidores, el más reciente primero, 25 por página. No hay ningún filtro de servidor: use server_hostname para agruparlos.

Permiso requerido: backups:list

Parámetros de consulta

Ejemplo de solicitud

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

Ejemplo de respuesta

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

Campos de respuesta

Códigos de estado de respuesta

Obtener una copia de seguridad

Devuelve un objeto de copia de seguridad con los campos anteriores.

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

Crear una copia de seguridad

Encola una copia de seguridad de un servidor desplegado. No se necesita ningún cuerpo de solicitud. La copia de seguridad aparece en la lista una vez que ha terminado, lo que puede tomar varios minutos dependiendo del uso del disco.

Permiso requerido: 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())

Ejemplo de respuesta

{
  "message": "Backup queued successfully"
}

Códigos de estado de respuesta

Restaurar un servidor desde una copia de seguridad

Detiene el servidor del que se tomó la copia de seguridad, sobreescribe su disco con la copia de seguridad y lo inicia de nuevo. No se necesita ningún cuerpo de solicitud. El estado del servidor es cola mientras se ejecuta la restauración.

Permiso requerido: 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"
}

Códigos de estado de respuesta

Notas

• Las copias de seguridad caducan automáticamente. Lea delection_date o days_reserving en lugar de asumir un período de retención.
• La API no puede eliminar una copia de seguridad.
• Las instantáneas son un recurso separado con sus propios puntos finales y no se enumeran aquí. API de instantáneas