VPS.org API

REST API ডকুমেন্টেশন

ব্যাকআপ API

সার্ভারের ব্যাকআপ তালিকাভুক্ত করুন, একটি নতুন ব্যাকআপ আরম্ভ করুন এবং সার্ভার থেকে একটি পুনরুদ্ধার করুন।

শেষবিন্দু 4
বেস পাথ /api/v1/backups
পান /api/v1/backups/

সকল ব্যাকআপ তালিকাভুক্ত করুন

আপনার সকল সার্ভারের ব্যাক-আপ ফিরিয়ে আনে, সর্বশেষ প্রথমে, প্রতি পৃষ্ঠা ২৫। কোন সার্ভার পরিশোধক নেই: তাদেরকে গ্রুপ করতে server_hostname ব্যবহার করুন।

অনুমতি প্রয়োজন: backups:list

কোয়েরি প্যারামিটার

পরামিতি আদর্শ প্রয়োজনীয় বর্ণনা
page integer না পৃষ্ঠার সংখ্যা, ১ থেকে আরম্ভ

উদাহরণ অনুরোধ

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

উদাহরণ প্রতিক্রিয়া

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

প্রতিক্রিয়া ক্ষেত্র

ক্ষেত্র আদর্শ বর্ণনা
id integer ব্যাক-আপ সনাক্তকারী, get এবং restore endpoints দ্বারা ব্যবহৃত
server_hostname string ব্যাক-আপ নেওয়া সার্ভারের হোস্টনেম
name string ব্যাক-আপ আর্কাইভ ফাইলের নাম
size_gb number সংকুচিত মাপ, জিগাবাইট-এ
deletion_date datetime ব্যাক-আপ স্বয়ংক্রিয়ভাবে কখন অপসারণ করা হবে
days_remaining integer মুছে ফেলার তারিখ পর্যন্ত পুরো দিন বাকি আছে
created_at datetime তৈরির সময় (ISO 8601, UTC)

প্রতিক্রিয়া স্থিতি কোড

200 ব্যাক-আপ তালিকা সফলভাবে উদ্ধার করা হয়েছে
403 API টোকেন অনুপস্থিত অথবা অবৈধ, অথবা টোকেনের প্রয়োজনীয় অনুমতি অনুপস্থিত
পান /api/v1/backups/{id}/

ব্যাক-আপ সংগ্রহ করুন

উপরের ক্ষেত্রগুলির সাথে একটি ব্যাক- আপ বস্তু ফিরিয়ে দেয় ।

curl -X GET "https://admin.vps.org/api/v1/backups/5512/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
পোস্ট /api/v1/servers/{uuid}/backup/

ব্যাক-আপ তৈরি করুন

সার্ভারের ব্যাক- আপের জন্য লাইন করে। কোন অনুরোধের প্রয়োজন নেই। ব্যাক- আপ শেষ হলে তালিকায় দেখা যাবে, ডিস্ক ব্যবহারের উপর নির্ভর করে এটি কয়েক মিনিট সময় নিতে পারে।

অনুমতি প্রয়োজন: 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())

উদাহরণ প্রতিক্রিয়া

{
  "message": "Backup queued successfully"
}

প্রতিক্রিয়া স্থিতি কোড

200 এই কাজটি কলামে রয়েছে
400 সার্ভার এখনো স্থাপন করা হয়নি
402 ফাইলে কোনো পরিশোধের পদ্ধতি নেই, অথবা অপ্রাপ্ত বিল
404 পাওয়া যায়নি, অথবা এটি অন্য অ্যাকাউন্টের অন্তর্ভুক্ত
পোস্ট /api/v1/backups/{id}/restore/

ব্যাক-আপ থেকে সার্ভার পুনরুদ্ধার করুন

সার্ভার বন্ধ করে যে থেকে ব্যাক-আপ নেওয়া হয়েছে, ব্যাক-আপ এর সাথে এর ডিস্কের উপরে লিখে এবং পুনরায় আরম্ভ করে। কোন অনুরোধের শরীরের প্রয়োজন নেই। সার্ভারের অবস্থা পুনরুদ্ধার চলাকালীন সময়ে লাইন।

অনুমতি প্রয়োজন: 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"
}
সতর্কীকরণ: ব্যাক-আপ নেওয়ার পর সার্ভারে লেখা সবকিছু হারিয়ে যাবে। পুনরুদ্ধার বাতিল করা যাবে না।

প্রতিক্রিয়া স্থিতি কোড

200 এই কাজটি কলামে রয়েছে
400 সার্ভার এখনো স্থাপন করা হয়নি
404 পাওয়া যায়নি, অথবা এটি অন্য অ্যাকাউন্টের অন্তর্ভুক্ত

নোট