How to Create VM via API for VPS Resellers

This article provides a guide for how to create VM via API for VPS resellers. A VPS Reseller account is required.

Use Create VM API to create new VPS on your Cloud Admin account.

How to Create VM via API for VPS Resellers

This function is for cloud user. You will need the API credentials to authenticate this request. Get your API credentials by following the guide: Get API Credentials

HTTP Request

https://vm1.apivps.com:4083/index.php?act=create

Parameters

SSH Options

There are three types of ssh_options which are described below:

1. add_ssh_keys: Pass your own public ssh key in post to add that ssh key in your vps.
2. generate_keys: If you want to create new pair of keys then you will first need to generate using the following link: https://radwebhosting.com/client_area/knowledgebase/348/Add-SSH-Key.html Once you have made the pair you will need to pass it to the ADDVS calls using following variables : $post[sshkey’] = ‘PUBLIC_KEY’; $post[‘private_key ‘] = ‘PRIVATE_KEY’;
3. use_ssh_keys :If you want to use existing key then first you will need to get list of sshkey using the following link: https://radwebhosting.com/client_area/knowledgebase/349/List-SSH-Keys.html Once you have made the pair you will need to pass it to the ADDVS calls using following variables: $post[existing_key’][] = ‘PUBLIC_KEY 1’; $post[‘existing_key ‘][] = ‘PUBLIC_KEY 2’;

Sample Code

PHP

<?php
require_once('/usr/local/virtualizor/sdk/enduser.php');
$key =  'your_api_key';
$pass = 'your_api_pass';
$ip = 'host_ip';
$admin = new Virtualizor_Enduser_API($ip, $key, $pass);
$post = array();
$post['virt'] = 'kvm';
$post['sgid'] = 12;
$post['rootpass'] ='Test123!!';   
$post['hostname'] = 'testcloud' ;
$post['space'] = 20 ;
$post['ram'] = 1024;
$post['swapram'] = 1024;
$post['bandwidth'] = 1000;
$post['uid'] = 372;
$post['cores'] = 2;
$post['ips'] = 1;
$post['vnc'] = 1;
$post['vncpass'] = 'testvnc';
$post['band_suspend'] = 1;
$post['osreinstall_limit'] = 0;
$post['osid'] = 955;
$post['addvs'] = 1;
$output = $admin->create($post);
print_r(json_encode($output));
?>

Curl

curl -k -X POST -d "addvs=1&virt=kvm&sgid=12&rootpass=Test123!!&hostname=testcloud&space=20&ram=1024&swap=1024&bandwidth=1000&uid=372&cpu=256&cores=8&ips=5&vnc=1&vncpass=testvnc&osid=955" -L "https://vm1.apivps.com:4083/index.php?act=create&api=json&apikey=your_api_key&apipass=your_api_pass"

Output

{
"uid": "372",
"act": "create",
"timezone": 1,
"timenow": "June 6, 2023,  2:09 am",
"vpsid": "3588",
"username": "test@test.com",
"user_type": "2",
"preferences": {
"fname": "test",
"lname": "test",
"theme": "default",
"language": "english",
"timezone": 1
},
"url": "index.php?",
"rdns": {
"pdnsid": "12"
},
"pdns": {
"pdnsid": "12"
},
"support_link": "http://radwebhosting.com",
"disable_login_logo": 1,
"title": "Launch Instance",
"resources": {
"num_vs": 99999,
"num_users": 15,
"space": 20,
"ram": 1024,
"burst": 1024,
"bandwidth": 1000,
"num_ipv4": 5,
"num_ipv6_subnet": 1,
"num_ipv6": "1",
"cores": "8",
"num_cores": "9996",
"network_speed": "128000",
"upload_speed": "128000",
"allowed_virts": {
"kvm": "kvm"
},
"cloud_allow_virtio": 1
},
"usage": {
"num_cores": "4"
},
"users": {
"372": {
"uid": "372",
"email": "test@test.com"
}
},
"ostemplates": {
"955": {
"osid": "955",
"type": "kvm",
"name": "centos-7.8-x86_64",
"filename": "centos-7.8-x86_64.img",
"size": "1560281088",
"pygrub": "0",
"drive": "",
"hvm": "0",
"perf_ops": "1",
"active": "1",
"url": "http://files.virtualizor.com/ostemplates.php?osid=955",
"distro": "centos",
"Nvirt": "kvm"
},
"943": {
"osid": "943",
"type": "kvm",
"name": "centos-8.2-x86_64",
"filename": "centos-8.2-x86_64.img",
"size": "2000683008",
"pygrub": "0",
"drive": "",
"hvm": "0",
"perf_ops": "1",
"active": "1",
"url": "http://files.virtualizor.com/ostemplates.php?osid=943",
"distro": "centos",
"Nvirt": "kvm",
"mg": [16]
},
"878": {
"osid": "878",
"type": "kvm",
"name": "debian-10-x86_64",
"filename": "debian-10-x86_64.img",
"size": "2738880512",
"pygrub": "0",
"drive": "",
"hvm": "0",
"perf_ops": "1",
"active": "1",
"url": "http://files.virtualizor.com/ostemplates.php?osid=878",
"distro": "debian",
"Nvirt": "kvm"
},
"979": {
"osid": "979",
"type": "kvm",
"name": "debian-11-x86_64",
"filename": "debian-11-x86_64.img",
"size": "2202009600",
"pygrub": "0",
"drive": "",
"hvm": "0",
"perf_ops": "1",
"active": "1",
"url": "http://files.virtualizor.com/ostemplates.php?osid=979",
"distro": "debian",
"Nvirt": "kvm"
},
"812": {
"osid": "812",
"type": "kvm",
"name": "ubuntu-18.04-x86_64",
"filename": "ubuntu-18.04-x86_64.img",
"size": "1732247552",
"pygrub": "0",
"drive": "",
"hvm": "0",
"perf_ops": "1",
"active": "1",
"url": "http://files.virtualizor.com/ostemplates.php?osid=812",
"distro": "ubuntu",
"Nvirt": "kvm"
},
},
"isos": {
"	debian-9.4.0-amd64-netinst.iso": {
"iso": "debian-9.4.0-amd64-netinst.iso",
"mg": [17],
"name": "debian-9.4.0-amd64-netinst.iso",
"filename": "debian-9.4.0-amd64-netinst.iso",
"size": 305135616,
"distro": "debian"
},
"Windows_2022_SERVER_EVAL_x64.iso": {
"iso": "Windows_2022_SERVER_EVAL_x64.iso",
"mg": "",
"name": "Windows_2022_SERVER_EVAL_x64.iso",
"filename": "Windows_2022_SERVER_EVAL_x64.iso",
"size": 5043650560,
"distro": "windows"
},
},
"servergroups": [{
"sgid": 12,
"sg_name": "test",
"sg_reseller_name": "USA",
"sg_desc": "This is just desc",
"sg_select": 0,
"virts": {
"kvm": "kvm",
"openvz": "openvz"
}
}],
"done": {
"done": "9999",
"msg": "The Virtual Server has been created",
"goto": "act=listvs"
},
"done_msg": "The Virtual Server has been created",
"newvs": {
"type": "kvm",
"sgid": 12,
"rootpass": "Test123!!",
"hostname": "testcloud",
"space": 20,
"ram": 1024,
"burst": 0,
"swapram": 1024,
"bandwidth": 1000,
"uid": 372,
"cores": 8,
"num_ipv4": 5,
"num_ipv6": 1,
"num_ipv6_subnet": 1,
"vnc": 1,
"vncpass": "testvnc",
"shadow": 0,
"iso": "",
"boot": "cda",
"band_suspend": 1,
"tuntap": 0,
"osreinstall_limit": 0,
"mg": "",
"osid": 955,
"virtio": 1,
"node_select": 1,
"server_group": 8,
"num_ips": 5,
"num_ips6": 1,
"num_ips6_subnet": 1,
"addvps": 1,
"vpsid": "9999",
"ips": ["10.10.100.6"],
"ips6": ["2602:fe6b:1020:1015:0000:0000:9407:22a1"],
"ipv6_subnet": ["2602:fe6b:1020:10eb::/64"]
},
"res_limit": {
"num_vs": "100000",
"num_users": "100000",
"space": "500",
"ram": "20480",
"bandwidth": "10000",
"num_ipv4": "20",
"num_ipv6_subnet": "20",
"num_ipv6": "20",
"num_cores": "10",
"cores": "8"
},
"virts": {
"kvm": "kvm",
},
"virt_lang": {
"kvm": "KVM",
},
"time_taken": "3.119"
}

Conclusion

You now know how to create VM via API for VPS Resellers.

Further Reading:

• How to Integrate VPS Reseller with WHMCS
• 6 Ways to Customize the VPS Panel With Your Branding – Cloud Admin Guide
• Rad Web Hosting – VPS and RDP Reseller Program
• Launching a Cloud VPS Business Is Now Easier Than Ever
• VPS Reseller API Guides