Серверийн 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 доллар)-ын түр хугацааны зөвшөөрөл олгох хугацааг тогтоож болно.

Зөвшөөрөл шаардагдана: 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 хаяг болон сүүлийн5үйлдэл зэргийг харуулна.

Зөвшөөрөл шаардагдана: 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 нууц үгийг сэргээх

Шинэ 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 зочин агентаар дамжуулан серверийн доторх shell командыг гүйцэтгэж дуусах хүртэл хүлээнэ. Серверийг ажиллуулж, 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 түлхүүрүүдийг хадгалж, сервер үүсгэх үед тэдний uuids-ийг 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"

Нууцлал ба зураг

Нэмэлт нөөц эсвэл зураг авах нь серверийн үйлдэл мөн:

• POST /api/v1/servers/{uuid}/backup/: Нөөцлөлт API
• POST /api/v1/servers/{uuid}/snapshot/: Агшин зургийн API