የአገልጋዮች ኤፒአይ

ሁሉንም አገልጋዮች ዘርዝር

በሂሳብዎ ውስጥ ያሉትን ሰርቨሮች፣ አዲስ መጀመሪያ፣ 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 ዶላር) ከአንድ ሳምንት በፊት በካርድዎ ላይ ሊጣል ይችላል። ሰርቨሩ ከመፍጠርዎ በፊት።

የፈቃድ መጠን: 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"
}

Example of a refused resize (409):

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

የምላሽ ሁኔታ ኮዶች

ሚስጢራዊ ቃል

አዲስ የሩት ሚስጢራዊ ቃል ይፈጥራል፣ በምላሹ ውስጥ ይመልሳል እና ለውጥን በሰርቨሩ ላይ ያስተላልፋል። አዲስ ሚስጢራዊ ቃልም በኢሜይል ወደ አንተ ይላካል። ሰርቨሩ መዘጋጀት አለበት። የጠየቀው አካል የለም

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

የምላሽ ሁኔታ ኮዶች

ተቀባይ

GET በሰርቨሩ ላይ የIPv4 እና IPv6 አድራሻዎች ሁሉ የቀየረውን የዲ ኤን ኤ ሆስት ስም ይዘረዝራል. POST ለአንድ አድራሻ ያስተካክላል. ባዶ ሆስት ስም መላክ አድራሻውን ወደ ቅድመ-ተቆጣጠረ የዲ ኤን ኤ ስም ይመለሳል

የፈቃድ መጠን: 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"
}

መልስ፦

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

የምላሽ ሁኔታ ኮዶች

ትእዛዝን አስጀምር

በሰርቨሩ ውስጥ የሴል ትእዛዝን በኪዩኤምዩ እንግዳ ተቀባይ አማካሪ በመስራት እና ለመጨረስ በመጠባበቅ ላይ ነው ሰርቨሩ መዘጋጀትና መሥራት አለበት፣ እና ኪዩኤምዩ- እንግዳ-ተቀባይ አማካሪ መጫን እና በተቀባዩ ውስጥ መሥራት አለበት

የፈቃድ መጠን: 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 ዩአይዲዎቻቸውን ይተዉ። 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"

መዝገብ ቤትን ክፈት

Creating a backup or a snapshot is also a server action:

• POST /api/v1/servers/{uuid}/backup/: ምትኬዎች ኤፒአይ
• POST /api/v1/servers/{uuid}/snapshot/: ቅጽበተ-ፎቶዎች ኤፒአይ