API-и нусхабардорӣ

Рӯйхати ҳамаи нусхаҳои эҳтиётӣ

Бозгардонидани нусхаи эҳтиётии ҳамаи серверҳои шумо, аввал навтарин, 25 дар як саҳифа. Филтри сервер вуҷуд надорад: барои гурӯҳбандӣ истифода баред server_ hostname.

Иҷозат лозим аст: backups:list

Параметрҳои дархост

Намунаи дархост

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

Намунаи посух

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

Майдонҳои посух

Рамзҳои ҳолати посух

Гирифтани нусхаи захиравӣ

Як объектро бо заминаҳои дар боло буда бар мегардонад.

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

Эҷоди нусхаи эҳтиётӣ

Дар навбати нусхаи эҳтиётии сервери истифодашударо мегузорад. Дархости бадан лозим нест. Баъди ба итмом расидани нусхаи эҳтиётӣ дар рӯйхат пайдо мешавад, ки ин метавонад чанд дақиқа вобаста ба истифодабарии дискро дар бар гирад.

Иҷозат лозим аст: 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())

Намунаи посух

{
  "message": "Backup queued successfully"
}

Рамзҳои ҳолати посух

Барқарор кардани сервер аз захираи нусхаи эҳтиётӣ

Серверро, ки нусхаи эҳтиётӣ аз он гирифта шуда буд, бозмедорад, диски онро бо нусхаи эҳтиётӣ аз нав менависад ва аз нав оғоз мекунад. Дархости бадан лозим нест. Ҳолати сервер дар навбати интизорӣ ҳангоми барқароркунӣ иҷро мешавад.

Иҷозат лозим аст: 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"
}

Рамзҳои ҳолати посух

Ёддоштҳо

• Захираҳои нусхаи эҳтиётӣ ба таври худкор ба итмом мерасанд. Санаи_ҳал кардан ё рӯзҳои_боқимондаро хонед, на давраи нигоҳдорӣ.
• API нусхаи эҳтиётиро нест карда наметавонад.
• Суратҳо манбаъи алоҳида бо нуқтаҳои охири худ мебошанд ва дар ин ҷо рӯйхат нашудаанд. API-и аксҳои снэпшотӣ