VPS.org API

പരിശോധന എപിഐ സഹായക്കുറിപ്പുകള്‍Query

സെർവറുകൾ API

നിങ്ങളുടെ വിപിഎസ് സേവകരെ സൃഷ്ടിക്കുക, പരിഷ്കരിക്കുക, വലിപ്പം മാറ്റുക, നീക്കം ചെയ്യുക.

എൻഡ്‌പോയിന്റുകൾ 15
ബേസ് പാത്ത് /api/v1/servers
നേടുക /api/v1/servers/

എല്ലാ സെർവറുകളും ലിസ്റ്റുചെയ്യുക

നിങ്ങളുടെ അക്കൌണ്ടില്‍ സര്‍വറുകള്‍ തിരികെവയ്ക്കുക, ആദ്യം പുതിയതായി, ഓരോ താളിലും 25 നല്‍കുക. നീക്കം ചെയ്യപ്പെടുന്ന സെര്‍വറുകള്‍ ഉള്‍പ്പെടുന്നില്ല.

അനുവാദം ആവശ്യമുണ്ട്: servers:list

അന്വേഷണ പാരാമീറ്ററുകൾ

പരാമീറ്റര്‍ ടൈപ്പ് ചെയ്യുക ആവശ്യമാണ് വിവരണം
page integer ഇല്ല താളിന്റെ നംബര്‍, 1 മുതല്‍
page_size integer ഇല്ല താളിലെ ഫലങ്ങള്‍ (default 25, പരമാവധി 100)

ഉദാഹരണ അഭ്യർത്ഥന

cURL
Python
JavaScript
PHP
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
    }
  ]
}

പ്രതികരണ ഫീൽഡുകൾ

ഫീള്‍ഡ് ടൈപ്പ് ചെയ്യുക വിവരണം
uuid string എല്ലാ സര്‍വറിന്റെ അവസാന പോയിന്റിലും സര്‍വര്‍ ഐഡന്റിഫയര്‍ ഉപയോഗിക്കുന്നു
hostname string സര്‍വറിനെ സൃഷ്ടിക്കുമ്പോള്‍ നിങ്ങള്‍ തെരഞ്ഞെടുത്ത ഹോസ്റ്റിന്റെ പേര്
status string ഇപ്പോഴത്തെ അവസ്ഥ. സര്‍വര്‍ നിലവാരത്തിന്റെ മൂല്യങ്ങള്‍ താഴെ കാണുക.
error_description string | null അവസ്ഥ തെറ്റുമ്പോള്‍ അവസാനമായി പരാജയപ്പെട്ട വിവരങ്ങള്‍, അല്ലെങ്കില്‍ ലഭ്യമല്ല
location_name string സെര്‍വര്‍ പ്രവര്‍ത്തിക്കുന്ന സ്ഥലത്തിന്റെ പേരു്
os_name string പ്രവര്‍ത്തന സിസ്റ്റത്തിന്റെ പേരു്, പതിപ്പില്ലാതെ
plan_name string റീഡ് ചെയ്യുവാന്‍ സാധിക്കുന്ന പ്ലാന്‍ പരമ്പര, ഉദാഹരണമായി 1 vCPU / 2 GB റാം / 10 GB
ipv4_addresses array IPv4 സ്ട്രിങ് ആയി വിലാസങ്ങള്‍. സര്‍വറിന്‍റെ ശൂന്യമാക്കുന്നതുവരെയും IPv4 ഇല്ലാതെയുള്ള പദ്ധതികളില്‍ നിന്നും കാലിയാകുക.
ipv6_addresses array IPv6 സ്ട്രിങ് ആയി വിലാസങ്ങള്‍. സര്‍വറില്‍ റെക്കോര്‍ഡ് ചെയ്യുന്നത് വരെ കാലിയാക്കുക.
created_at datetime Creation time (ISO 8601, UTC)
deployed boolean സത്യമായ ക്രമീകരണം അവസാനിച്ച ശേഷം

പ്രതികരണ സ്റ്റാറ്റസ് കോഡുകൾ

200 സെർവർ ലിസ്റ്റ് വിജയകരമായി വീണ്ടെടുത്തു.
403 API അടയാളം ലഭ്യമല്ല അല്ലെങ്കില്‍ ആവശ്യമുളള സൂചനയ്ക്ക് ലഭ്യമല്ല
പോസ്റ്റ് /api/v1/servers/

പുതിയ സെർവർ സൃഷ്ടിക്കുക

ഒരു പുതിയ സര്‍വര്‍ ‍ നിര്‍ദ്ദേശങ്ങള്‍ക്കായി ഒരു പുതിയ സര്‍വര്‍ ക്രമീകരിച്ചു് നിലവാര റെയിന്റ് ഉപയോഗിച്ച് നല്‍കുന്നു. ക്രമീകരണങ്ങള്‍ പശ്ചാത്തലത്തില്‍ തുടരുന്നു: പ്രവര്‍ത്തനം സാധിയ്ക്കുന്ന വരെ അവസ്ഥാ-അന്തം തുടരുന്നു. സര്‍വര്‍ തയ്യാറായാല്‍, അതിന്റെ ലോഗിന്‍ വിവരങ്ങള്‍ അക്കൌണ്ട് ഉടമസ്ഥനിലേക്ക് അയയ്ക്കുന്നു.

Your account needs a saved payment method. Depending on your account history, a temporary pre-authorization hold of about one week of the plan price (at least 1 USD) may be placed on your card before the server is created.

അനുവാദം ആവശ്യമുണ്ട്: servers:create

ബോഡി പാരാമീറ്ററുകൾ അഭ്യർത്ഥിക്കുക

പരാമീറ്റര്‍ ടൈപ്പ് ചെയ്യുക ആവശ്യമാണ് വിവരണം
hostname string അതെ കുറഞ്ഞത് 3 അക്ഷരങ്ങൾ, അക്കങ്ങൾ, ഹിഫന്‍സ്, പീരിയൽ എന്നിവ മാത്രം.
location_id integer അതെ സ്ഥാനങ്ങളില്‍ നിന്നും API-ല്‍ നിന്നും സജീവമായ ഒരു സ്ഥലംയുടെ ഐഡി
plan_uuid string അതെ പ്ലാന്‍സ് എപിഐ യില്‍ നിന്നും ഒരു സജീവ പദ്ധതിയുടെ യുഐഡി
operating_system_version_uuid string അതെ ഓപ്പറേറ്റിങ് സിസ്റ്റത്തിന്റെ പതിപ്പുകളുടെ പട്ടികയില്‍ സജീവമായ എന്‍ട്രിയുടെ യുഐഡി
ssh_key_uuids array ഇല്ല സര്‍വറില്‍ ഇന്‍സ്റ്റോള്‍ ചെയ്യാന്‍ SSH കീകളില്‍ നിന്നും ഉളള കീകള്‍ API
ssh_key_ids array ഇല്ല എസ്എസ്_ കീ_ കീകള്‍ക്കുള്ള പകരമായി SS_Uids എന്ന കീയുടെ പൂര്‍ണ്ണമായ ഐഡികള്‍. രണ്ടും അയച്ചാല്‍, ssh_ കീ_ key_ids ഉപയോഗിയ്ക്കപ്പെടുന്നു.
ssh_key_uuid, ssh_key_id string, integer ഇല്ല ഒരു SSH കീയ്ക്കുള്ള ഹ്രസ്വമായ വില
auth_method string ഇല്ല അടയാളവാക്ക്, ssh_ കീ അല്ലെങ്കില്‍ രണ്ടും. അടയാളവാക്കു്, അല്ലെങ്കില്‍ SS കീകള്‍ ലഭ്യമാകുമ്പോള്‍ രണ്ടു് തവണ.

ഉദാഹരണ അഭ്യർത്ഥന

cURL
Python
JavaScript
PHP
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);

ഉദാഹരണ പ്രതികരണം

201 സര്‍വര്‍ വിവരങ്ങള്‍ക്ക് താഴെ പറഞ്ഞിരിക്കുന്ന പൂര്‍ണ്ണ സര്‍വറില്‍ സൃഷ്ടിച്ചു. വിലാസങ്ങളും 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": []
}

പ്രതികരണ സ്റ്റാറ്റസ് കോഡുകൾ

201 എക്സ്റ്റെന്റേഷന്‍ സര്‍വര്‍ നിര്‍മ്മിച്ചു, ക്രമപ്പെടുത്തി
400 ഉദാഹരണത്തിന്, നിര്‍ജ്ജീവമായ സ്ഥലം, പദ്ധതി അല്ലെങ്കില്‍ ഓപ്പറേറ്റിങ് സിസ്റ്റം പതിപ്പു്, പരിഷ്കരിക്കുന്നതില്‍ സാധുത തെറ്റാണു്
402 ഫയലില്‍ പണത്തിന്റെ രീതിയോ, പ്ളഗില്‍ നിന്നും ഉപയോഗമില്ലാത്തവയോ, കാര്‍ഡ് മുന്‍ഗണനാ സംവിധാനം നിരസിച്ചു
403 API അടയാളം ലഭ്യമല്ല അല്ലെങ്കില്‍ ആവശ്യമുളള സൂചനയ്ക്ക് ലഭ്യമല്ല
429 നിങ്ങളുടെ അക്കൌണ്ട് സര്‍വറിന്‍റെ സൃഷ്ടിയുടെ പരിധിയില്‍ എത്തിയിരിക്കുന്നു
നേടുക /api/v1/servers/{uuid}/

സെർവർ വിശദാംശങ്ങൾ നേടുക

ഒരു സര്‍വര്‍, അതിന്‍റെ സ്ഥാനവും പദ്ധതിയും ഓപ്പറേഷന്‍ സിസ്റ്റവും IP വിലാസം, ഏറ്റവും അടുത്തിടെയുള്ള അഞ്ച് പ്രവര്‍ത്തനങ്ങളും നല്‍കുന്നു.

അനുവാദം ആവശ്യമുണ്ട്: 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"
    }
  ]
}

എസ്‌വിജി ചിഹ്നത്തിന്റെ മാര്‍ക്കപ്പ്, പതിപ്പുകളുടെ പട്ടിക ഇവിടെ കുറയ്ക്കുന്നു.

പ്രതികരണ ഫീൽഡുകൾ

ഫീള്‍ഡ് ടൈപ്പ് ചെയ്യുക വിവരണം
vmid integer | null Virtual machine number, set during deployment
location object Location object, as returned by the Locations API
plan object പ്ലാന്‍ വസ്തു API തിരികെ നല്‍കിയതുപോലെ
operating_system, operating_system_version object ഓപ്പറേറ്റിങ് സിസ്റ്റം എപിഐ ലഭ്യമാക്കിയ സിസ്റ്റങ്ങളും ഇന്‍സ്റ്റോള്‍ ചെയ്ത പതിപ്പും
ipv4_addresses, ipv6_addresses array ip, ഗേറ്റ്, സബ്നെറ്റ്, എര്‍ഡ്സ് (പ്രവര്‍ത്തന ഹോസ്റ്റിന്റെ വിപരീത) ഒരു വസ്തു
recent_actions array 5 ഏറ്റവും പുതിയ നടപടികള്‍: ഐഡി, പ്രവര്‍ത്തനങ്ങള്‍, നടപടി,_display, വിവരണം, ഉപയോക്താവിന്റെ_email, _cat_t

പ്രതികരണ സ്റ്റാറ്റസ് കോഡുകൾ

200 സെർവർ വിശദാംശങ്ങൾ വിജയകരമായി വീണ്ടെടുത്തു.
404 ഇല്ല, അല്ലെങ്കില്‍ മറ്റൊരു പ്രമാണം മാത്രമേ അവര്‍ക്ക് ലഭിക്കുകയുള്ളൂ.
നേടുക /api/v1/servers/{uuid}/status/

സെര്‍വര്‍ അവസ്ഥ ലഭ്യമാക്കുക

നിങ്ങള്‍ നിര്‍മ്മിച്ചതിനു ശേഷം ഒരു കംപ്യൂട്ടര്‍ കോള്‍ ആവശ്യ‌പ്പെട്ടിരിക്കുന്നു, വൈദ്യുതിയോ, സര്‍വറിന്‍റെ വലിപ്പം മാറ്റണമോ.

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
}

സര്‍വര്‍ അവസ്ഥ മൂല്യങ്ങള്‍

മൂല്യം വിവരണം
queue ഒരു നടപടി (തെറ്റായ, ശക്തി, വലിപ്പം, പുനഃസ്ഥാപിക്കല്‍) അല്ലെങ്കില്‍ പുരോഗതിയില്‍ ആണ്
deploying ക്രമീകരിച്ചിരിയ്ക്കുന്നു. കണ്‍ട്രോള്‍ പാനല്‍ നിന്നും ഉണ്ടാക്കിയിരിക്കുന്ന സര്‍വര്‍ ഈ അവസ്ഥ ഉപയോഗിക്കുന്നു; സജ്ജമാകുന്നതുവരെ API വഴി നിര്‍മ്മിച്ചിരിക്കുന്ന സര്‍വറുകള്‍ ‍.
on ഓടിക്കൊണ്ടിരിക്കുന്നു
off ഊര്‍ജ്ജം നിര്‍ത്തിയിരിക്കുന്നു
error അവസാന നടപടി പരാജയപ്പെട്ടു. പിശകിന്റെ_തട്ടങ്ങള്‍ കാണുക.
suspended_payment ഡ്വാർഫുകളാണ് അപ്രസക്തമായത്.
പോസ്റ്റ് /api/v1/servers/{uuid}/power/

നിയന്ത്രണ സേവകന്റെ പവര്‍

ഒരു വൈദ്യുതി നടപടി ക്രമീകരിക്കുന്നു. നടപടി പൂര്‍ത്തിയാകുന്നതുവരെ സെര്‍വര്‍ അവസ്ഥ റെയിന്റ് ചെയ്യുന്നു.

അനുവാദം ആവശ്യമുണ്ട്: servers:power

ബോഡി പാരാമീറ്ററുകൾ അഭ്യർത്ഥിക്കുക

പരാമീറ്റര്‍ ടൈപ്പ് ചെയ്യുക ആവശ്യമാണ് വിവരണം
action string അതെ start: ഊര്‍ജ്ജം
shutdown: അതിഥി നിര്‍ത്തുന്നില്ലെങ്കില്‍, നല്ല കിടിലം പിടിക്കും.
restart: ഹാര്‍ഡ്‌ വൈദ്യുതി ചക്രം (അതിനു ശേഷം തുടങ്ങുക)
stop: ഇപ്പോള്‍ വൈദ്യുതി വീണ്ടും ആരംഭിക്കുന്നതുപോലെ അതേ പരിവൃത്തി നടത്തുന്നു. ഒരു സര്‍വറിനെ ഒഴിവാക്കാന്‍ നിര്‍ത്തല്‍ ഉപയോഗിക്കുക.

ഉദാഹരണ അഭ്യർത്ഥന

cURL
Python
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"
}

പ്രതികരണ സ്റ്റാറ്റസ് കോഡുകൾ

200 നടപടി ക്രമീകരിച്ചിരുന്നു
400 പിന്തുണ ലഭ്യമല്ലാത്ത അല്ലെങ്കില്‍ പിന്തുണ ലഭ്യമല്ല
402 അക്കൌണ്ട് സബ്ടൈറ്റില്‍ പിന്തുണ ലഭ്യമല്ലാത്തതിനാല്‍ തുടങ്ങി
404 ഇല്ല, അല്ലെങ്കില്‍ മറ്റൊരു പ്രമാണം മാത്രമേ അവര്‍ക്ക് ലഭിക്കുകയുള്ളൂ.
പോസ്റ്റ് /api/v1/servers/{uuid}/resize/

സെര്‍വര്‍ വലിപ്പം മാറ്റുക

സെര്‍വര്‍ പ്രവര്‍ത്തിക്കുന്ന മറ്റൊരു പദ്ധതിയിലേക്ക് മാറ്റുന്നു. പുതിയ പദ്ധതിക്ക് ഇപ്പോഴുള്ള ഒരു പദ്ധതിയേക്കാള്‍ കുറവ് ഡിസ്കില്‍ ഉണ്ടാവില്ല, അപേക്ഷാ ശരീരത്തില്‍ വലിപ്പം മാറ്റുന്നതിനായി സജ്ജീകരിക്കണം. പുതിയ പദ്ധതിയുടെ ഹൈപ്പര്‍വിസറിന്റെ കഴിവു് സംവിധാനത്തിന്റെ ഗതികള്‍ പരിശോധിക്കുന്നതിനു് മുമ്പു് പരിശോധിയ്ക്കപ്പെടും, അതുകൊണ്ട് ഒരു അപേക്ഷ സമ്മതം സര്‍വര്‍വര്‍ക്ക് മാറ്റവുമല്ല.

വലിപ്പം മാറ്റുമ്പോള്‍ സര്‍വര്‍ അടച്ചു പൂട്ടിയിരിക്കുന്നു, പിന്നീട് വീണ്ടും ആരംഭിക്കുന്നു. വലിപ്പം നഷ്ട്ടപ്പെട്ടാല്‍, സര്‍വര്‍ മുന്‍പുളള പദ്ധതിയില്‍ തന്നെ നിര്‍ത്തി, അത് പ്രവര്‍ത്തിക്കുന്നുണ്ടെങ്കില്‍ വീണ്ടും തുടങ്ങുന്നു. ഡിസ്ക് വളർച്ച വീണ്ടെടുക്കുവാന്‍ സാധ്യമല്ല.

അനുവാദം ആവശ്യമുണ്ട്: servers:resize

ബോഡി പാരാമീറ്ററുകൾ അഭ്യർത്ഥിക്കുക

പരാമീറ്റര്‍ ടൈപ്പ് ചെയ്യുക ആവശ്യമാണ് വിവരണം
action string അതെ വലിപ്പം മാറ്റേണ്ടതാണു്
new_plan_uuid string അതെ നീങ്ങാനുള്ള പദ്ധതിയുടെ യുഐഡി
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"
}

നിരസിച്ച വലിപ്പം (409):

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

പ്രതികരണ സ്റ്റാറ്റസ് കോഡുകൾ

200 നടപടി ക്രമീകരിച്ചിരുന്നു
400 നഷ്ടപ്പെട്ട നടപടി അല്ലെങ്കില്‍ പുതിയ__ഗ്യുഐഡി (_uid), അസാധുവായ അല്ലെങ്കില്‍ നിര്‍ജ്ജീവമായ പദ്ധതി, ഡിസ്കില്‍ കുറവുള്ള ഒരു പദ്ധതി, അല്ലെങ്കില്‍ ജിപിയു പദ്ധതി (GPU പദ്ധതികള്‍ API വഴി വലിപ്പം മാറ്റാന്‍ സാധ്യമല്ല)
404 ഇല്ല, അല്ലെങ്കില്‍ മറ്റൊരു പ്രമാണം മാത്രമേ അവര്‍ക്ക് ലഭിക്കുകയുള്ളൂ.
409 ഒരു വലിപ്പം അല്ലെങ്കില്‍ സംഭരണം പുരോഗതിയില്‍ ആണ്, അല്ലെങ്കില്‍ പുതിയ പദ്ധതിയ്ക്കുള്ള ആവശ്യത്തിന് ഹൈപ്പര്‍വിസറുടെ കഴിവ് ഇല്ല
503 ഇപ്പോള്‍ പരിശോധിയ്ക്കുവാന്‍ സാധ്യമായില്ല. സര്‍വറില്‍ മാറ്റം വരുത്തിയിട്ടില്ല; പിന്നീട് വീണ്ടും ശ്രമിക്കുക.
പോസ്റ്റ് /api/v1/servers/{uuid}/reset-password/

റൂട്ട് അടയാളവാക്ക് പുന:സ്ഥാപിക്കുക

ഒരു പുതിയ റൂട്ട് പാസ്‌വേര്‍ഡ് ഉണ്ടാക്കുന്നു, മറുപടിയില്‍ അത് തിരിച്ചു്‌അയക്കുകയും സര്‍വറിലെ മാറ്റങ്ങള്‍ വരിക്കുകയും ചെയ്യുന്നു. പുതിയ പാസ്‍വേര്‍ഡ് നിങ്ങള്‍ക്ക് ഈ മെയില്‍ അയയ്ക്കാവുന്നതാണ്. സര്‍വര്‍ നീക്കം ചെയ്യേണ്ടതില്ല.

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

പ്രതികരണ സ്റ്റാറ്റസ് കോഡുകൾ

200 നടപടി ക്രമീകരിച്ചിരുന്നു
400 സര്‍വര്‍ ഇതുവരെ കമ്പ്യൂട്ടറില്‍ പെടുത്തിയിട്ടില്ല
404 ഇല്ല, അല്ലെങ്കില്‍ മറ്റൊരു പ്രമാണം മാത്രമേ അവര്‍ക്ക് ലഭിക്കുകയുള്ളൂ.
നേടുക പോസ്റ്റ് /api/v1/servers/{uuid}/rdns/

വിയറ്റ്നാം DNS (പിടി)

സര്‍വറില്‍ എല്ലാ IPv4 ന്റെയും IPv6 വിലാസത്തിന്റെയും ആവര്‍ത്തിയുടെ വിപരീത ഹോസ്റ്റ് ലിസ്റ്റ് ചെയ്യുന്നു. PPUST അത് ഒരു വിലാസത്തിനു് സജ്ജമാക്കുന്നു. ഒരു ഒഴിഞ്ഞ ഹോസ്റ്റ് ഹോസ്റ്റ്നാമം കൂടി ഇത് അതിന്റെ സഹജമായ DNS നാമത്തിലേക്ക് പുനഃസ്ഥാപിക്കുന്നു.

അനുവാദം ആവശ്യമുണ്ട്: servers:update

ബോഡി പാരാമീറ്ററുകൾ അഭ്യർത്ഥിക്കുക (POST)

പരാമീറ്റര്‍ ടൈപ്പ് ചെയ്യുക ആവശ്യമാണ് വിവരണം
ip string അതെ ഈ സര്‍വറിലേക്ക് നല്‍കിയ ഒരു IPv4 അല്ലെങ്കില്‍ IPv6 വിലാസം
hostname string ഇല്ല PTR ഹോസ്റ്റിന്റെ പേരു്. സഹജമായതിലേക്ക് വീണ്ടും മാറ്റുന്നതിനായി കാലിയായി വിടുക.
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"
}

മറുപടി എടുക്കുക:

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

പ്രതികരണ സ്റ്റാറ്റസ് കോഡുകൾ

400 അല്ലെങ്കില്‍ ഹോസ്റ്റ്നാമം സജ്ജമാക്കാന്‍ കഴിഞ്ഞില്ല
404 ഈ സര്‍വറിലേക്ക് ഐപി വിലാസം നല്‍കുന്നതല്ല
പോസ്റ്റ് /api/v1/servers/{uuid}/exec/

ഒരു സെര്‍വറില്‍ ആജ്ഞ പ്രവര്‍ത്തിപ്പിയ്ക്കുക

QEMU അതിഥി ഏജന്റ് വഴി ഒരു ഷെല്‍ കമാന്‍ഡ് പ്രവര്‍ത്തിക്കുന്നു. അത് പൂര്‍ത്തിയാക്കാന്‍ കാത്തിരിക്കുന്നു. സര്‍വറിനെ മയക്കിയിട്ട് പ്രവര്‍ത്തിപ്പിയ്ക്കുകയും വേണം, ക്വിമു-ഗുസ്റ്റ് ഇന്‍സ്റ്റോള്‍ ചെയ്യപ്പെടുകയും വേണം.

അനുവാദം ആവശ്യമുണ്ട്: servers:exec

ബോഡി പാരാമീറ്ററുകൾ അഭ്യർത്ഥിക്കുക

പരാമീറ്റര്‍ ടൈപ്പ് ചെയ്യുക ആവശ്യമാണ് വിവരണം
command string അതെ /bin/sh -c- ല്‍ കമാന്‍ഡ് ലൈന്‍ പ്രവര്‍ത്തിപ്പിയ്ക്കുന്നു, 2000 അക്ഷരങ്ങള്‍ വരെ
timeout integer ഇല്ല ആജ്ഞയ്ക്കു് കാത്തിരിക്കുവാനുള്ള സെക്കന്റുകള്‍, 1 മുതല്‍ 300 (സഹജമായ 30)
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
}

സമയം തീരുമ്പോള്‍ ആജ്ഞ പ്രവര്‍ത്തനനിരതമാണെങ്കില്‍, മറുപടി ശരിക്കുള്ള_സമയസജ്ജമാക്കി, നീക്കം ചെയ്ത _കോഡിങ്ങു് നിര്‍ത്തുക.

പ്രതികരണ സ്റ്റാറ്റസ് കോഡുകൾ

200 ആജ്ഞ പൂര്‍ത്തിയായി അല്ലെങ്കില്‍ സമയം തീര്‍ന്നു
400 സര്‍വര്‍ ശൂന്യമല്ല അല്ലെങ്കില്‍ പ്രവര്‍ത്തിക്കുന്നില്ല
409 QEMU അതിഥി ഏജന്റ് സര്‍വറില്‍ പ്രവര്‍ത്തിക്കുന്നില്ല
503 താല്‍ക്കാലിക ബന്ധം പ്രശ്നം. റീട്രി-പിന് ശേഷം ഹെഡിനു് ശേഷം വീണ്ടും ശ്രമിക്കുക.
ഇല്ലാതാക്കുക /api/v1/servers/{uuid}/

സെർവർ ഇല്ലാതാക്കുക

സ്ഥിരമായ നീക്കം ചെയ്യുന്നതിനായി സര്‍വറിന്‍റെ വരികള്‍ ക്രമീകരിക്കുന്നു. സര്‍വര്‍ ഉടനെ പട്ടികയില്‍ നിന്നും മറഞ്ഞു പോകുന്നു, വീണ്ടെടുക്കുവാന്‍ സാധ്യമല്ല.

അനുവാദം ആവശ്യമുണ്ട്: 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"
}

പ്രതികരണ സ്റ്റാറ്റസ് കോഡുകൾ

202 സ്വീകരിച്ചിരിക്കുന്നു: ആവശ്യം നിലച്ചു
404 ഇല്ല, അല്ലെങ്കില്‍ മറ്റൊരു പ്രമാണം മാത്രമേ അവര്‍ക്ക് ലഭിക്കുകയുള്ളൂ.
നേടുക പോസ്റ്റ് /api/v1/ssh-keys/

SSH കീകള്‍

നിങ്ങളുടെ അക്കൌണ്ടില്‍ പൊതുവായ SS കീകള്‍ സൂക്ഷിക്കുക, പിന്നെ ഒരു സര്‍വര്‍ നിര്‍മ്മിക്കുമ്പോള്‍ അവ ssh_ കീ_ uids ആയി നല്‍കുക. നിങ്ങള്‍ കീകള്‍ ലഭ്യമാക്കുക ( താളില്‍ 25); PSS ഒന്നിനെയും ചേര്‍ക്കുന്നു.

അനുവാദം ആവശ്യമുണ്ട്: ssh-keys:list (GET), ssh-keys:create (POST)

ബോഡി പാരാമീറ്ററുകൾ അഭ്യർത്ഥിക്കുക (POST)

പരാമീറ്റര്‍ ടൈപ്പ് ചെയ്യുക ആവശ്യമാണ് വിവരണം
name string അതെ കീ തിരിച്ചറിയുന്നതിനുളള പേരു്, 100 അക്ഷരങ്ങളോളം
public_key string അതെ The public key in OpenSSH format, for example the contents of id_ed25519.pub

ഉദാഹരണ അഭ്യർത്ഥന

cURL
Python
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
}

പ്രതികരണ ഫീൽഡുകൾ

ഫീള്‍ഡ് ടൈപ്പ് ചെയ്യുക വിവരണം
id, uuid integer, string കീ തിരിച്ചറിയുന്നവര്‍. ssh_key_uids ല്‍ uid ഉപയോഗിക്കുക. യുആര്‍എല്‍ താഴെയുള്ള യുഐഡി; ഐഡി ssh_ കീ_ idids- ല്‍ പ്രവര്‍ത്തിക്കുന്നു.
fingerprint string പ്ലാറ്റ്ഫോമുപയോഗിച്ചു് കണക്കുകൂട്ടുന്ന കീയുടെ MD5 വിരലടയാളം
last_used_at datetime | null ഒരു പുതിയ സര്‍വറിലേയ്ക്ക് അവസാനമായി കീ ഇന്‍സ്റ്റോള്‍ ചെയ്യുമ്പോള്‍

പ്രതികരണ സ്റ്റാറ്റസ് കോഡുകൾ

201 കീ ചേര്‍ത്തിരിക്കുന്നു
400 ലഭ്യമല്ലാത്ത പേരു് അല്ലെങ്കില്‍ പൊതുവാക്കുളള കീ സാധുതയില്ലാത്ത ഒരു എസ്എസ്എച്ച് കീ അല്ല
നേടുക ഇല്ലാതാക്കുക /api/v1/ssh-keys/{uuid}/

ഒരു SSH കീ എടുക്കുകയോ നീക്കം ചെയ്യുകയോ ചെയ്യുക

ഒരു കീ മുകളിലുള്ള വയലുകളില്‍ നിന്നും തിരികെ നല്‍കുക. DEEE നിങ്ങളുടെ അക്കൌണ്ടില്‍ നിന്നും നീക്കം ചെയ്തു, ശരീരം ഇല്ലാതെ 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"

കരുതലുകളും സ്നൈറ്റ് ഹോട്ട്സും

ഒരു ബാക്കപ്പ് അല്ലെങ്കില്‍ ഒരു സ്പോട്ട്ലി ഉണ്ടാക്കുന്നതും സര്‍വര്‍ പ്രവര്‍ത്തനത്തിന്റെ പ്രവര്‍ത്തിയാണ്: