ਸਰਵਰ 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 ਕੁੰਜੀਆਂ ਸਟੋਰ ਕਰੋ, ਫਿਰ ਜਦੋਂ ਤੁਸੀਂ ਸਰਵਰ ਬਣਾਓ ਤਾਂ ਉਨ੍ਹਾਂ ਦੇ 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