VPS.org API

టెక్స్టు API పత్రికీకరణQuery

సర్వర్ల API

VPS సెర్వర్లను సృష్టించుము, పరికరించు, ప్రభావమును సృష్టించుము, పునఃపరిమాణం చేయుము మరియు తొలగించుము. uid వలన సెర్వర్లు గుర్తించ బడింది.

అంత్య బిందువులు 15
బేస్ పాత్ /api/v1/servers
పొందండి /api/v1/servers/

అన్ని సర్వర్‌లను జాబితా చేయండి

మీ ఖాతానందు సెర్వర్లను తిరిగిరమ్ము, ముందుగా కొత్త, పుటలొ 25 కొత్తకి పంపుము. తొలగించబడుతున్న సెర్వర్లు చేర్చబడలేదు.

అనుమతించు: servers:list

ప్రశ్న పారామితులు

పెరామీటరు రకం అవసరం విశదీకరణము
page integer వద్దు పుట సంఖ్య, 1 నుంచి ప్రారంభము
page_size integer వద్దు పేజీకు ఫలితాలు (అప్రమేయంగా 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 Name of the location the server runs in
os_name string ఫార్మేట్ సిస్టమ్ పేరు, లేకుండా
plan_name string సిటి స్మారకచిహ్నం, ఉదాహరణకు 1 vCPU / 2 GB RAM / 10 బి
ipv4_addresses array IPv4 చిరునామాలు స్ట్రింగ్స్‌గా. సెర్వర్ రిపార్టు చేయబడే వరకు, IPv4 లేకుండా పథకాల్లో ఖాళీగా ఉంటుంది.
ipv6_addresses array IPv6 చిరునామాలు స్ట్రింగ్స్‌గా. సెర్వర్ నిస్సారమయ్యేంతవరకు ఖాళీ.
created_at datetime సృష్టి సమయం (ఐఎస్ ఓ 8601, యు డి ఐ)
deployed boolean వాస్తవ ఏర్పాటు పూర్తైనది

ప్రతిస్పందన స్థితి కోడ్‌లు

200 సర్వర్ జాబితాను విజయవంతంగా తిరిగి పొందారు.
403 చెల్లని API గుర్తు లేదా అవసరమైన సూచనకు లేదా గుర్తించవలసిన అనుమతి లేదు
పెరా /api/v1/servers/

కొత్త సర్వర్‌ను సృష్టించండి

కొత్త సెర్వర్ను క్రమముచేసి స్థితి వరుసతో దానిని తిరిగిఅమర్చు. బ్యాక్‌గ్రౌండ్‌నందు కొనసాగుతుంది: కౌంట్‌బాక్‍స్ సత్యమే అయినంత వరకు స్థితి పట్టీని స్టేట్‌బార్ చేయుము. సెర్వర్ సిద్ధంగా ఉన్నప్పుడు దాని లాగిన్ వివరాలు ఖాతా యజమానికి పంపబడతాయి.

మీ ఖాతాకు ఒక దాచబడిన చెల్లింపు పద్దతి అవసరం. మీ ఖాతా చరిత్ర ఆధారంగా, మీ పథకపు విక్రయానికి ఒక వారానికి ముందుగా అంశపు సంభందం కలిగివుంటుంది (కనీసం. 1D) మీ కార్డు పైన పెట్టవచ్చు.

అనుమతించు: servers:create

బాడీ పారామితులను అభ్యర్థించండి

పెరామీటరు రకం అవసరం విశదీకరణము
hostname string అవును కనీసం 3 అక్షరాలు. అక్షరాలు, సంఖ్యలు, హిప్టెన్లు మరియు కాలం మాత్రమే.
location_id integer అవును స్థానములు API నుండి క్రియాశీల స్థానము యొక్క గుర్తింపు
plan_uuid string అవును The uuid of an active plan from the Plans API
operating_system_version_uuid string అవును ఒక ఆపరేటింగ్ సిస్టమ్ వర్షన్ల జాబితానందు క్రియాశీల ప్రవేశము యొక్క uuid
ssh_key_uuids array వద్దు సెర్వర్నందు సంస్థాపించుటకు SSH కీలనుండి USP కీల UIDలు
ssh_key_ids array వద్దు Ssh_key_uids కు ప్రత్యామ్నాయముగా, SSH కీల పూర్ణసంఖ్యా ఐడిలేటర్లు. ఇద్దరిని పంపితే, ssh_key_ids వుపయోగించబడుతుంది.
ssh_key_uuid, ssh_key_id string, integer వద్దు ఒక ASH కీ కొరకు చిన్నచిరువ
auth_method string వద్దు సంకేతపదము, ssh_key లేదా రెండు. అప్రమేయంగా సంకేతపదమునకు, లేదా SSH కీలు అందివ్వబడినప్పుడు రెండింటికీ.

ఉదాహరణ అభ్యర్థన

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 Server created and queued for deployment
400 Validation error, for example an inactive location, plan or operating system version
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"
    }
  ]
}

SVG ప్రతిమ మార్కప్ మరియు వర్షన్ జాబితా ఇక్కడ తక్కువైనవి.

ప్రతిస్పందన ఫీల్డ్‌లు

క్షేత్రము రకం విశదీకరణము
vmid integer | null Virtual machine number, set during deployment
location object స్థానము API ద్వారా తిరిగివుంచబడినది
plan object Plans API ద్వారా తిరిగి పొందుతున్న పథకం
operating_system, operating_system_version object ఆపరేటింగ్ సిస్టమ్‌లు API ద్వారా తిరిగివుంచబడిన, ఆప్టేషన్ వర్షన్‌ను మరియు సంస్థాపించబడిన వర్షన్‌ను తిరిగివుంచింది
ipv4_addresses, ipv6_addresses array ip, గేట్‌కాల్‌, ఉపనెట్ మరియు rds (విస్మరించిన DNS హోస్ట్) తో ఒక వస్తువు (విస్మరించిన DNS హోస్ట్)
recent_actions array ఐదు తాజా చర్యల వరకు: UID, చర్య, చర్య,_caret, వివరణ, వినియోగదారి_mail, సృష్టించబడింది_at

ప్రతిస్పందన స్థితి కోడ్‌లు

200 సర్వర్ వివరాలను విజయవంతంగా తిరిగి పొందారు.
404 దొరకలేదు, లేక మరొక ఖాతాకి చెందినది అదిలేదు
పొందండి /api/v1/servers/{uuid}/status/

సెర్వర్ స్థితిని పొందుముComment

మీరు దానిని వ్రాసిన తర్వాత, సెర్వరును రూపొందించుటకు తక్కువ నిక్కైన కాల్.

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 An action (deploy, power, resize, restore) is queued or in progress
deploying కేటాయింపబడినవి. నియంత్రణ పానెల్ నుంచి సృష్టించబడినవి ఈ స్థితిని వుపయోగించును; సిజిక్ ద్వారా సృష్టించబడినవి సిద్ధంగా పర్యవేక్షించేవి.
on నడుస్తున్న
off పవర్ ఆఫ్
error చివరి చర్య విఫలమైంది. దోషం_ prefix చూడండి.
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 చర్య క్రమాంతరంగా వుందిQNativeSocketEngine
400 కనబడని లేదా మద్దతులేని చర్య
402 ఖాతా ప్రొటొకాల్లలో అచేతనం కాలేదు
404 దొరకలేదు, లేక మరొక ఖాతాకి చెందినది అదిలేదు
పెరా /api/v1/servers/{uuid}/resize/

Resize a Server

సెర్వర్ను వేరొక క్రియాశీల పథకానికి కదుపుము. కొత్త పథకము యిప్పటికన్నా తక్కువ డిస్క్ లో వుండదు, అభ్యర్ధన చట్రం ను పునఃపరిమాణం చేయుటకు అమర్చబడి ఉండాలి. కొత్త ప్రణాళిక కొరకు ఏ పధకము కావాలంటే NAME OF TRANSLATORS

సెర్వర్ పునఃపరిమాణం చేయబడి దాని తర్వాత ప్రారంభించబడింది. పునఃపరిమాణం కోల్పోయాంటే, సెర్వర్ దాని మునుపటి ప్రణాళికనందు తిరిగి పెట్టి అది నడుస్తున్నప్పుడు మరలా ప్రారంభించబడుతుంది.

అనుమతించు: servers:resize

బాడీ పారామితులను అభ్యర్థించండి

పెరామీటరు రకం అవసరం విశదీకరణము
action string అవును తప్పక పునఃపరిమాణము
new_plan_uuid string అవును The uuid of the plan to move to 
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 చర్య క్రమాంతరంగా వుందిQNativeSocketEngine
400 కనబడని చర్య లేదా కొత్త_ప్లాస్_uid, చెల్లని లేదా క్రియాహీన ప్రణాళిక, తక్కువ డిస్క్ స్థలం, లేదా GPU పధకం (GPU పధకాన్ని API ద్వారా పునఃపరిమాణం చేయలేము)
404 దొరకలేదు, లేక మరొక ఖాతాకి చెందినది అదిలేదు
409 రూపాంతరం లేదా నిల్వ మార్పు ఇప్పటికే వుంటుంది, లేదా కొత్త పథకానికి తగినంత హైపర్‌విజర్ సామర్థ్యం లేదు
503 సాంపియే ఇప్పుడు పరిశీలించలేక పోయింది. సెర్వర్ మార్చబడలేదు; తరువాత మళ్ళీ ప్రయత్నించు.
పెరా /api/v1/servers/{uuid}/reset-password/

Reset Root 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 చర్య క్రమాంతరంగా వుందిQNativeSocketEngine
400 సెర్వర్ ఇంకా సిద్దంచేయబడలేదు
404 దొరకలేదు, లేక మరొక ఖాతాకి చెందినది అదిలేదు
పొందండి పెరా /api/v1/servers/{uuid}/rdns/

ఫాంట్ ఆర్ ఎస్ వి (ప్లిటి)

ఔట్‌కాల్ చెయబడిన అన్ని IPv4 మరియు IPv6 చిరునామాల విస్మరించండి. పోస్ట్ దానిని ఒక చిరునామాకు అమర్చుతుంది. ఖాళీ హోస్ట్ పంపుట దానిని అప్రమేయ 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 spec, లేదా హోస్ట్ పేరు అమర్చలేక పోయింది
404 ఈ సేవికకు IP చిరునామా పంపబడలేదు
పెరా /api/v1/servers/{uuid}/exec/

Run a Command on a Server

QEMU అతిథి ఎజెంట్ ద్వారా దరఖాస్తు ఆదేశాన్ని లోపలకి రన్న చేస్తుంది మరియు దానిని పూర్తిచేయుటకు వేచివుంటుంది. server మరమ్మత్తుచేయబడి, అమలు చేయబడి ఉండాలి, qmuu-genest-gestive ఇన్స్టాల్ చెయ్యాలి మరియు అతిథిలో నడుపుకు ఉండాలి.

అనుమతించు: 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 అంగీకరించబడిన: మనవి క్రమాంతరీకరణం చేయబడిందిQNativeSocketEngine
404 దొరకలేదు, లేక మరొక ఖాతాకి చెందినది అదిలేదు
పొందండి పెరా /api/v1/ssh-keys/

ఎస్ మీటలు

మీ ఖాతానందు SSH కీలను నిల్వవుంచు, తరువాత మీరు సెర్వర్ సృష్టించునప్పుడు వాటి UIDలను ssh_key_uids గా పంపండి. మీ కీలను (కప్పకు 25వ పేజీ) వ్రాయండి. PST ఒకటి జతచేస్తుంది.

అనుమతించు: ssh-keys:list (GET), ssh-keys:create (POST)

బాడీ పారామితులను అభ్యర్థించండి (POST)

పెరామీటరు రకం అవసరం విశదీకరణము
name string అవును కీను గుర్తించుటకు పేరు, 100 అక్షరములకు,
public_key string అవును ఉదాహరణకు, ఓపెన్ ఎస్ ఎస్ హెచ్ ఫార్మాట్ లో సాధారణ కీ, UID_cid25519. 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 లోను మరియు క్రింద వున్న URLనందును ఉయుఐడిని వుపయోగించుము; ID ssh_key_ids నందు పనిచేస్తుంది.
fingerprint string ప్లాట్‌ఫాం ద్వారా కౌంట్, కీ యొక్క MD5 నిగూఢమైన
last_used_at datetime | null కీ ని చివరిగా కొత్త సెర్వర్‌నందు స్థాపించబడినప్పుడు

ప్రతిస్పందన స్థితి కోడ్‌లు

201 కీ జతచేయబడింది
400 కనబడని పేరు, లేదా ఉమ్మడి పేరు చెల్లని SSH సర్వర్ కీ కాదు
పొందండి తొలగించు /api/v1/ssh-keys/{uuid}/

ASD కీను తేండి లేదా తొలగించు

పైనున్న క్షేత్రాలతో ఒక కీను తిరిగిఅమర్చు. 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"

బ్యాక్అప్లు మరియు స్నాప్ హాట్స్

బ్యాక్అప్ లేదా స్పెల్‌కార్డింగ్‌ను సృష్టించుట కూడా సెర్వర్ చర్య: