সার্ভার এপিআই

সকল সার্ভারের তালিকা তৈরি করুন

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

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

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

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

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

import requests

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

response = requests.get(url, headers=headers)
for server in response.json()["results"]:
    print(server["uuid"], server["hostname"], server["status"])

const response = await fetch('https://admin.vps.org/api/v1/servers/', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
});

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

$ch = curl_init('https://admin.vps.org/api/v1/servers/');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer YOUR_API_TOKEN']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$data = json_decode(curl_exec($ch), true);
curl_close($ch);

foreach ($data['results'] as $server) {
    echo $server['hostname'] . ' ' . $server['status'] . "\n";
}

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

{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b",
      "hostname": "web-01",
      "status": "on",
      "error_description": null,
      "location_name": "New Jersey",
      "plan_name": "1 vCPU / 2 GB RAM / 10 GB",
      "os_name": "Ubuntu",
      "ipv4_addresses": ["203.0.113.10"],
      "ipv6_addresses": ["2001:db8:2:dd::f9:6b"],
      "created_at": "2026-07-30T03:54:14.914364Z",
      "deployed": true
    },
    {
      "uuid": "2d7e9b40-6c1a-4f3e-8b5d-9a0c1e2f3b4d",
      "hostname": "db-01",
      "status": "queue",
      "error_description": null,
      "location_name": "New Jersey",
      "os_name": "Debian",
      "ipv4_addresses": [],
      "ipv6_addresses": [],
      "created_at": "2026-09-14T19:33:49.426508Z",
      "deployed": false
    }
  ]
}

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

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

নতুন সার্ভার তৈরি করুন

নতুন সার্ভারকে বিতরণ করার জন্য লাইন করে এবং তা অবিলম্বে অবস্থার লাইন সহ ফিরিয়ে দেয়। প্রদান পটভূমিতে চলতে থাকে: অবস্থার শেষ বিন্দুতে যতক্ষণ না বিতরণ করা হয়েছে তা সত্য হয়। সার্ভার প্রস্তুত হলে, এর লগ-ইন তথ্য অ্যাকাউন্টের মালিককে ই-মেইল করা হয়।

আপনার অ্যাকাউন্টের জন্য একটি সংরক্ষিত পরিশোধের পদ্ধতি প্রয়োজন। আপনার অ্যাকাউন্টের ইতিহাসের উপর নির্ভর করে, সার্ভার তৈরির পূর্বে আপনার কার্ডের উপর প্রকল্পের মূল্যের এক সপ্তাহের অস্থায়ী পূর্ব-অনুমোদন (অন্তত $১) রাখা হতে পারে।

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

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

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

curl -X POST "https://admin.vps.org/api/v1/servers/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "hostname": "web-01",
    "location_id": 1,
    "plan_uuid": "3bc2faf6-8f8b-4978-b62d-b52ed3f858e9",
    "operating_system_version_uuid": "c3418f90-80a0-4e00-a7e1-d0ab1822b941",
    "ssh_key_uuids": ["YOUR_SSH_KEY_UUID"]
  }'

import requests

url = "https://admin.vps.org/api/v1/servers/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}
data = {
    "hostname": "web-01",
    "location_id": 1,
    "plan_uuid": "3bc2faf6-8f8b-4978-b62d-b52ed3f858e9",
    "operating_system_version_uuid": "c3418f90-80a0-4e00-a7e1-d0ab1822b941",
    "ssh_key_uuids": ["YOUR_SSH_KEY_UUID"],
}

response = requests.post(url, headers=headers, json=data)
server = response.json()
print(response.status_code, server["uuid"], server["status"])

const response = await fetch('https://admin.vps.org/api/v1/servers/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    hostname: 'web-01',
    location_id: 1,
    plan_uuid: '3bc2faf6-8f8b-4978-b62d-b52ed3f858e9',
    operating_system_version_uuid: 'c3418f90-80a0-4e00-a7e1-d0ab1822b941',
    ssh_key_uuids: ['YOUR_SSH_KEY_UUID']
  })
});

const server = await response.json();
console.log(server.uuid, server.status);

$data = [
    'hostname' => 'web-01',
    'location_id' => 1,
    'plan_uuid' => '3bc2faf6-8f8b-4978-b62d-b52ed3f858e9',
    'operating_system_version_uuid' => 'c3418f90-80a0-4e00-a7e1-d0ab1822b941',
    'ssh_key_uuids' => ['YOUR_SSH_KEY_UUID']
];

$ch = curl_init('https://admin.vps.org/api/v1/servers/');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_TOKEN',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$server = json_decode(curl_exec($ch), true);
curl_close($ch);

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

২০১ সার্ভার বিস্তারিত জানতে নীচে বর্ণিত পূর্ণ সার্ভার বস্তুর সাথে তৈরি করা হয়েছে । ডিপ্লোমেটেশন শেষ হলে ঠিকানা এবং vmid পূরণ করা হবে ।

{
  "uuid": "5f0c8e2a-6b1d-4c3e-9a7f-2d4b6c8e0a1f",
  "hostname": "web-01",
  "vmid": null,
  "status": "queue",
  "error_description": null,
  "location": {
    "id": 1,
    "name": "New Jersey",
    "country_name": "United States",
    "is_active": true
  },
  "plan": {
    "uuid": "3bc2faf6-8f8b-4978-b62d-b52ed3f858e9",
    "cpu": 1,
    "ram": 2,
    "ram_unit": "GB",
    "disk_space": 10,
    "disk_space_total": 10240,
    "transfer": 500,
    "price": "3.50",
    "cpu_type_name": "Shared",
    "is_active": true,
    "hourly_price": "0.005",
    "monthly_price": "3.50",
    "is_gpu": false,
    "gpu_count": 0,
    "gpu_model": ""
  },
  "operating_system": {
    "id": 1,
    "name": "Ubuntu",
    "svg_icon": "<svg ...>",
    "versions": [ ... ]
  },
  "operating_system_version": {
    "uuid": "c3418f90-80a0-4e00-a7e1-d0ab1822b941",
    "name": "24.04 LTS x64",
    "os_name": "Ubuntu",
    "os_svg_icon": "<svg ...>",
    "is_active": true
  },
  "ipv4_addresses": [],
  "ipv6_addresses": [],
  "deployed": false,
  "created_at": "2026-09-14T21:02:11.402113Z",
  "recent_actions": []
}

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

সার্ভারের বিবরণ পান

একটি সার্ভার এর অবস্থান, পরিকল্পনা, অপারেটিং সিস্টেম, আই. পি. ঠিকানা এবং পাঁচটি সাম্প্রতিক কাজ সঙ্গে ফিরিয়ে আনে ।

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

curl -X GET "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

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

{
  "uuid": "8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b",
  "hostname": "web-01",
  "vmid": 1042,
  "status": "on",
  "error_description": null,
  "location": {
    "id": 1,
    "name": "New Jersey",
    "country_name": "United States",
    "is_active": true
  },
  "plan": {
    "uuid": "14186969-fbaf-43e1-9ab2-b1f1aeb66674",
    "cpu": 1,
    "ram": 2,
    "ram_unit": "GB",
    "disk_space": 25,
    "disk_space_total": 25600,
    "transfer": 1,
    "price": "5.00",
    "cpu_type_name": "Shared",
    "is_active": true,
    "hourly_price": "0.007",
    "monthly_price": "5.00",
    "is_gpu": false,
    "gpu_count": 0,
    "gpu_model": ""
  },
  "operating_system": {
    "id": 1,
    "name": "Ubuntu",
    "svg_icon": "<svg ...>",
    "versions": [ ... ]
  },
  "operating_system_version": {
    "uuid": "c3418f90-80a0-4e00-a7e1-d0ab1822b941",
    "name": "24.04 LTS x64",
    "os_name": "Ubuntu",
    "os_svg_icon": "<svg ...>",
    "is_active": true
  },
  "ipv4_addresses": [
    {
      "ip": "203.0.113.10",
      "gateway": "203.0.113.1",
      "subnet": "203.0.113.0",
      "rdns": "web-01.example.com"
    }
  ],
  "ipv6_addresses": [
    {
      "ip": "2001:db8:2:dd::f9:6b",
      "gateway": "2001:db8:2:dd::f9:1",
      "subnet": "2001:db8:2:dd::f9:0",
      "rdns": "web-01.example.com"
    }
  ],
  "deployed": true,
  "created_at": "2026-07-30T03:54:14.914364Z",
  "recent_actions": [
    {
      "id": 17028,
      "action": "create",
      "action_display": "Create",
      "description": "Server deployed with VMID 1042",
      "user_email": "you@example.com",
      "created_at": "2026-07-30T03:54:32.860854Z"
    }
  ]
}

এস- ভি- জি আইকন মারক এবং সংস্করণ তালিকা এখানে সংক্ষিপ্ত করা হয়েছে ।

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

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

সার্ভারের অবস্থা প্রাপ্ত করো

সার্ভার তৈরি, চালু অথবা আকার পরিবর্তন করার পর পলিং করার জন্য একটি হালকা কল।

curl -X GET "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/status/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "status": "on",
  "deployed": true,
  "resizing": false
}

সার্ভারের অবস্থার মান

সার্ভারের শক্তি নিয়ন্ত্রণ করুন

একটি বিদ্যুৎ সংক্রান্ত কাজের জন্য লাইন স্থাপন করে। কাজ সম্পন্ন না হওয়া পর্যন্ত সার্ভারের অবস্থা লাইন স্থাপনের দিকে পরিবর্তন হয়।

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

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

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

curl -X POST "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/power/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "restart"}'

import requests

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

response = requests.post(url, headers=headers, json={"action": "restart"})
print(response.json())

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

{
  "message": "Server restart queued"
}

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

সার্ভার- এর আকার পরিবর্তন করুন

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

সার্ভারটি মাপ পরিবর্তনের সময় বন্ধ করা হয় এবং এরপর আবার আরম্ভ করা হয়। মাপ পরিবর্তন ব্যর্থ হলে সার্ভারটি পূর্ববর্তী পরিকল্পনায় ফিরে আসে এবং আবার আরম্ভ করা হয় যদি এটি চলছে। ডিস্কের বৃদ্ধি বাতিল করা যায় না।

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

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

curl -X POST "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/resize/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "resize", "new_plan_uuid": "5e26a4a6-bd0c-467c-abca-da036c811c3f"}'

{
  "message": "Resize queued successfully"
}

একটি প্রত্যাখ্যাত মাপ পরিবর্তনের উদাহরণ (৪০৯):

{
  "error": "Not enough hypervisor capacity for the selected plan; the server was not changed"
}

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

root পাসওয়ার্ড পুনরায় নির্ধারণ করো

একটি নতুন root পাসওয়ার্ড তৈরি করে, প্রতিক্রিয়ায় তা ফিরিয়ে দেয় এবং সার্ভারে পরিবর্তনের জন্য লাইন করে । নতুন পাসওয়ার্ডটি আপনাকে ই- মেইল করেও পাঠানো হয় । সার্ভার অবশ্যই স্থাপন করা হবে । কোন অনুরোধের বডি প্রয়োজন হয় না ।

curl -X POST "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/reset-password/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "message": "Password reset queued. New password will also be emailed to you.",
  "password": "generated-password",
  "job_id": "b6f1c7e2-3a4d-4f5e-8b9c-0d1e2f3a4b5c"
}

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

বিকল্প DNS (PTR)

GET সার্ভারের প্রতিটি IPv4 এবং IPv6 ঠিকানা এর বিপরীত DNS হোস্টনেম তালিকাভুক্ত করে । POST এটি একটি ঠিকানা জন্য নির্ধারণ করে । ফাঁকা হোস্টনেম পাঠানো ঠিকানাটি তার ডিফল্ট বিপরীত DNS নাম পুনরায় নির্ধারণ করে ।

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

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

curl -X POST "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/rdns/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"ip": "203.0.113.10", "hostname": "mail.example.com"}'

{
  "message": "Reverse DNS for 203.0.113.10 set to mail.example.com",
  "ip": "203.0.113.10",
  "hostname": "mail.example.com"
}

GET প্রতিক্রিয়া:

{
  "rdns": [
    {"ip": "203.0.113.10", "hostname": "mail.example.com"},
    {"ip": "2001:db8:2:dd::f9:6b", "hostname": "mail.example.com"}
  ]
}

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

সার্ভারে কমান্ড চালাও

QEMU অতিথি এজেন্টের মাধ্যমে সার্ভারের মধ্যে একটি শেল কমান্ড চালায় এবং শেষ হওয়ার জন্য অপেক্ষা করে। সার্ভার অবশ্যই স্থাপন করা এবং চলমান হতে হবে, এবং qemu-guest-agent অবশ্যই ইনস্টল করা এবং অতিথির মধ্যে চলমান হতে হবে।

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

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

curl -X POST "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/exec/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"command": "uptime", "timeout": 30}'

{
  "stdout": " 21:14:03 up 46 days,  2:10,  0 users,  load average: 0.08, 0.03, 0.01\n",
  "stderr": "",
  "exit_code": 0,
  "timed_out": false
}

সময়সীমা শেষ হওয়ার সময় যদি কমান্ড চালানো হয়, তবে প্রত্যুত্তরে timed_out মান true এবং exit_code মান null নির্ধারণ করা হবে।

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

সার্ভার মুছুন

স্থায়ীভাবে মুছে ফেলার জন্য সার্ভারকে লাইন করা হয়। সার্ভারটি তালিকা থেকে অবিলম্বে অদৃশ্য হয়ে যায় এবং পুনরুদ্ধার করা যায় না।

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

curl -X DELETE "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "message": "Server deletion queued"
}

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

SSH কী

আপনার অ্যাকাউন্টে পাবলিক SSH কী সংরক্ষণ করুন, তারপর সার্ভার তৈরি করার সময় তাদের uuids ssh_key_uuids হিসাবে প্রদান করুন। GET আপনার কী তালিকাভুক্ত করে (প্রতি পৃষ্ঠা ২৫); POST একটি যোগ করে।

অনুমতি প্রয়োজন: ssh-keys:list (GET), ssh-keys:create (POST)

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

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

curl -X POST "https://admin.vps.org/api/v1/ssh-keys/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "laptop", "public_key": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAI... you@laptop"}'

import requests

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

with open("/home/you/.ssh/id_ed25519.pub") as f:
    data = {"name": "laptop", "public_key": f.read().strip()}

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

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

{
  "id": 19,
  "uuid": "6e1b9c52-3f8a-4d7e-a2c4-5b9d0e1f2a3c",
  "name": "laptop",
  "public_key": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAI... you@laptop",
  "fingerprint": "0b:4c:9b:48:76:e7:1d:07:b9:ac:71:90:70:f7:9a:69",
  "created_at": "2026-08-23T19:16:11.547183Z",
  "last_used_at": null
}

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

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

SSH কী প্রাপ্ত অথবা মুছে ফেলা হবে

GET উপরের ক্ষেত্র সহ একটি কী ফিরিয়ে দেয়। DELETE এটি আপনার অ্যাকাউন্ট থেকে অপসারণ করে এবং কোন বডি ছাড়া 204 ফিরিয়ে দেয়। একটি কী মুছে ফেলার ফলে সার্ভার থেকে এটি মুছে ফেলা হবে না যেখানে এটি ইতিমধ্যেই ইনস্টল করা হয়েছে। কী সম্পাদন করা যাবে না: মুছে ফেলা এবং পুনরায় যোগ করা হবে।

অনুমতি প্রয়োজন: ssh-keys:list (GET), ssh-keys:delete (DELETE)

curl -X DELETE "https://admin.vps.org/api/v1/ssh-keys/6e1b9c52-3f8a-4d7e-a2c4-5b9d0e1f2a3c/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

ব্যাক-আপ এবং স্ন্যাপশট

ব্যাক-আপ বা স্ন্যাপশট তৈরি করাও সার্ভারের কাজ:

• POST /api/v1/servers/{uuid}/backup/: ব্যাকআপ API
• POST /api/v1/servers/{uuid}/snapshot/: স্ন্যাপশট API