சேவையகங்கள் API

அனைத்து சேவையகங்களையும் பட்டியலிடுங்கள்

உங்கள் கணக்கில் உள்ள சேவையகங்களை திரும்பத் தரும், புதியது முதலில், பக்கத்திற்கு 25. சேவையகங்கள் நீக்கப்படுகின்றன.

அனுமதி தேவை: 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
    }
  ]
}

பதில் புலங்கள்

பதில் நிலை குறியீடுகள்

புதிய சேவையகத்தை உருவாக்கு

புதிய சேவையகத்தை நிறுவ வரிசையில் நிறுத்துகிறது மற்றும் உடனடியாக நிலை வரிசைகளுடன் திரும்பும். பின்னணியில் வழங்குதல் தொடரும்: நிறுவப்பட்ட நிலை முடிவு புள்ளி உண்மையான வரை நிலையை கேட்கவும். சேவையகம் தயாராக இருக்கும் போது, அதன் நுழைவு விவரங்கள் கணக்கு உரிமையாளர்களுக்கு மின்னஞ்சல் மூலம் அனுப்பப்படும்.

உங்கள் கணக்கிற்கு சேமிக்கப்பட்ட செலுத்தும் முறை தேவை. உங்கள் கணக்கின் வரலாற்றை பொறுத்து, சேவையகம் உருவாக்கப்படுவதற்கு முன், உங்கள் அட்டையில் ஒரு வாரத்திற்கு ஒரு திட்ட விலை (கொஞ்சம் கூடுதலாக 1 USD) தற்காலிக முன்- அனுமதி நிறுத்தம் வைக்கப்படலாம்.

அனுமதி தேவை: 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);

எடுத்துக்காட்டு பதில்

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": []
}

பதில் நிலை குறியீடுகள்

சேவையக விவரங்களைப் பெறுங்கள்

ஒரு சேவையகத்தை அதன் இடம், திட்டம், இயக்க முறைமை, 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"
    }
  ]
}

SVG சின்னம் குறி மற்றும் பதிப்பு பட்டியல் இங்கே குறுக்கிடப்பட்டுள்ளது.

பதில் புலங்கள்

பதில் நிலை குறியீடுகள்

சேவையக நிலையை பெறு

நீங்கள் சேவையகத்தை உருவாக்கிய பின், இயக்கிய பின் அல்லது மாற்றிய பின், ஒரு இலகுவான குரல் கேட்கப்படுகிறது.

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

மறுக்கப்பட்ட மறு அளவுக்கான உதாரணம் (409):

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

பதில் நிலை குறியீடுகள்

ரூட் கடவுச்சொல்லை மீளமை

புதிய 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 உண்மை எனவும் exit_code நூல் எனவும் அமைக்கப்படும்.

பதில் நிலை குறியீடுகள்

சேவையகத்தை நீக்கு

சேவையகத்தை நிரந்தரமாக நீக்க வரிசையில் வைக்கிறது. சேவையகம் பட்டியலிலிருந்து உடனடியாக மறைந்துவிடும் மற்றும் மீட்டெடுக்க முடியாது.

அனுமதி தேவை: 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 விசைகளை உங்கள் கணக்கில் சேமிக்கவும், பின்னர் சேவையகத்தை உருவாக்கும்போது ssh_key_uuids ஆக அவற்றின் uuids களை அனுப்பவும். GET உங்கள் விசைகளை பட்டியலிடுகிறது (பக்கத்திற்கு 25); 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