VPS.org API

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

স্ন্যাপশট API

সার্ভারের লেবেলযুক্ত স্ন্যাপশট নিন, তাদের তালিকা করুন এবং আপনার আর প্রয়োজন না এমনগুলো মুছে ফেলুন।

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

সমস্ত স্ন্যাপশট তালিকাভুক্ত করুন

আপনার অ্যাকাউন্টের স্ন্যাপশটগুলি ফিরিয়ে আনে, সর্বশেষ প্রথমে, প্রতি পৃষ্ঠা ২৫।

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

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

cURL
Python
JavaScript
curl -X GET "https://admin.vps.org/api/v1/snapshots/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
import requests

url = "https://admin.vps.org/api/v1/snapshots/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.get(url, headers=headers)
for snapshot in response.json()["results"]:
    print(snapshot["uuid"], snapshot["label"], snapshot["ready"])
const response = await fetch('https://admin.vps.org/api/v1/snapshots/', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
});

const data = await response.json();
console.log(data.results);

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

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "3f9a1c0e5b7d4e2f8a6c1b3d5e7f9a0b",
      "label": "before-upgrade",
      "server_hostname": "web-01",
      "ready": true,
      "deleting": false,
      "created_at": "2026-09-14T18:30:00.000000Z",
      "size_gb": 3.4
    }
  ]
}

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

ক্ষেত্র আদর্শ বর্ণনা
uuid string স্ন্যাপশট সনাক্তকারী (৩২ hex অক্ষর, কোন হাইফান নেই)
label string স্ন্যাপশট তৈরি করার সময় লেবেল দেওয়া হয়েছে
server_hostname string স্ন্যাপশট নেওয়া সার্ভারের হোস্টনেম, অথবা সার্ভারের অস্তিত্ব না থাকলে null
ready boolean স্ন্যাপশট শেষ হলে সত্য
deleting boolean মুছে ফেলার প্রক্রিয়া চলছে তখন সত্য
created_at datetime তৈরির সময় (ISO 8601, UTC)
size_gb number সংকুচিত মাপ, জিগাবাইট-এ
পান /api/v1/snapshots/{uuid}/

স্ন্যাপশট নিন

উপরের ক্ষেত্রগুলির সাথে একটি স্ন্যাপশট বস্তু ফিরিয়ে দেয় । একটি স্ন্যাপশট তৈরি করার পরে এটি ব্যবহার করে প্রস্তুত পলিং করতে ।

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

স্ন্যাপশট তৈরি করুন

একটি প্রয়োগকৃত সার্ভারের স্ন্যাপশট লাইন করে এবং নতুন স্ন্যাপশটের uuid ফিরিয়ে দেয়। স্ন্যাপশটটি তৎক্ষণাৎ তালিকাভুক্ত করা হবে এবং প্রস্তুত মান false নির্ধারণ করা হবে।

অনুমতি প্রয়োজন: servers:snapshot

অনুরোধ বডি প্যারামিটার

পরামিতি আদর্শ প্রয়োজনীয় বর্ণনা
action string হাঁ স্ন্যাপশট অবশ্যই হতে হবে
snapshot_label string হাঁ স্ন্যাপশট সনাক্ত করার জন্য একটি লেবেল
cURL
Python
curl -X POST "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/snapshot/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "snapshot", "snapshot_label": "before-upgrade"}'
import requests

server_uuid = "8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b"
url = f"https://admin.vps.org/api/v1/servers/{server_uuid}/snapshot/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}
data = {"action": "snapshot", "snapshot_label": "before-upgrade"}

response = requests.post(url, headers=headers, json=data)
print(response.json()["snapshot_uuid"])

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

{
  "message": "Snapshot queued successfully",
  "snapshot_uuid": "3f9a1c0e5b7d4e2f8a6c1b3d5e7f9a0b"
}

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

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

স্ন্যাপশট মুছে ফেলুন

স্থায়ীভাবে মুছে ফেলার জন্য স্ন্যাপশটকে লাইন করা হয়। মুছে ফেলা যতক্ষণ না তা মুছে ফেলা হয় ততক্ষণ সত্য।

অনুমতি প্রয়োজন: snapshots:delete

curl -X DELETE "https://admin.vps.org/api/v1/snapshots/3f9a1c0e5b7d4e2f8a6c1b3d5e7f9a0b/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "message": "Snapshot deletion queued"
}

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

202 গ্রহণ করা হয়েছে: অনুরোধটি কলামে রাখা হয়েছে
404 পাওয়া যায়নি, অথবা এটি অন্য অ্যাকাউন্টের অন্তর্ভুক্ত

নোট