Use the List Virtual Server API to list all the Virtual Private Servers present on your Server.
A Virtual Private Server is an instance of your physical server that appears to the user as a dedicated server. The list contains all information about the VPS such as the hostname, the OS installed, CPU cores and bandwidth allocated. which are listed according to the VPS IDs. To filter or limit the size of the list, you can specify one or more query parameters.
HTTP Request
https://hostname:4085/index.php?act=vs&vpsid=id&vpsname=vpsname&vpsip=vpsip&
vpshostname=vpshostname&vsstatus=vsstatus&vstype=vstype&speedcap=speedcap&
user=user&vsgid=vsgid&vserid=vserid&plid=plid&bpid=bpid&search=Search
CURL
curl -k -L “https://HOSTNAME/IP:4085/index.php?act=vs&api=json&apikey=APIKEY&curl_api=1″
Search Parameters
Name | Method | Value | Description | Required |
---|---|---|---|---|
vpsid | POST | Int | Search using id | No |
vpsname | POST | Int | Search using vid | No |
vpsip | POST | text | Results will be returned on the basis of the ip | No |
vpshostname | POST | text | VPS is searched on the basis of the hostname passed | No |
vsstatus | POST | text | VPS is searched on the basis of the status of the vps (type ‘s’ for suspended, type ‘u’ for unsuspended) | No |
vstype | POST | text | VPS is searched on the basis of the type of virtualization, refer below table for valid values | No |
speedcap | POST | text | VPS is searched on the basis of the type of speed cap (type 1 for enabled, 2 for disabled ) | No |
user | POST | text | Search for the vps according to the user | No |
vsgid | POST | Comma Separated Values | Search for the vps according to the server group | No |
vserid | POST | Comma Separated Values | VPS is searched on the basis of the server | No |
plid | POST | Comma Separated Values | VPS is searched on the basis of plan that it has been assigned | No |
bpid | POST | Comma Separated Values | VPS is searched on the basis of backup plan that it has been assigned | No |
reslen | GET | Int | Number of records to be returned, default is 50 | No |
page | GET | Int | Page number, each page show 50 records | No |
Values for vstype can be anyone from below :
(xen | xenhvm | xcp | xcphvm | openvz | kvm | lxc | vzo | vzk | proxo | proxk | proxl) |
Sample Code
<?php
require_once('/usr/local/virtualizor/sdk/admin.php');
$key = 'your_api_key';
$pass = 'your_api_pass';
$ip = 'your_server_ip';
$admin = new Virtualizor_Admin_API($ip, $key, $pass);
$page = 0;
$reslen = 0;
//For Searching
$post = array();
$post['vpsid'] = '';
$post['vpsname'] = '';
$post['vpsip'] = '';
$post['vpshostname'] = '';
$post['vsstatus'] = '';
$post['vstype'] = '';
$post['speedcap'] = '';
$post['user'] = '';
$post['vsgid'] = '';
$post['vserid'] = '';
$post['plid'] = '';
$post['bpid'] = '';
$post['serid'] = '';
$post['search'] = '';
$output = $admin->listvs($page ,$reslen ,$post);
print_r(json_encode($output));
?>
Output
{
"37": {
"vpsid": "37",
"vps_name": "v1001",
"uuid": "mark7ygoeqtfdf72",
"serid": 0,
"time": "1534260671",
"edittime": "1534499180",
"virt": "kvm",
"uid": "55",
"plid": "1",
"hostname": "www.mydomainff.com",
"osid": "270",
"os_name": "centos-6.5-x86",
"iso": "",
"sec_iso": "",
"boot": "cda",
"space": "2",
"inodes": "0",
"ram": "128",
"burst": "0",
"swap": "128",
"cpu": "1000",
"cores": "1",
"cpupin": "-1",
"cpu_percent": "0.00",
"bandwidth": "1",
"network_speed": "0",
"upload_speed": "-1",
"io": "0",
"ubc": "a:0:{}",
"acpi": "1",
"apic": "1",
"pae": "1",
"shadow": "0",
"vnc": "1",
"vncport": "5901",
"vnc_passwd": "",
"hvm": "0",
"suspended": "0",
"suspend_reason": null,
"nw_suspended": null,
"rescue": "0",
"band_suspend": "0",
"tuntap": "0",
"ppp": "0",
"ploop": "0",
"dns_nameserver": "a:0:{}",
"osreinstall_limit": "0",
"preferences": null,
"nic_type": "virtio",
"vif_type": "",
"virtio": "0",
"pv_on_hvm": "0",
"disks": null,
"kvm_cache": "0",
"io_mode": "0",
"cpu_mode": "default",
"total_iops_sec": "0",
"read_bytes_sec": "0",
"write_bytes_sec": "0",
"kvm_vga": "0",
"acceleration": "0",
"vnc_keymap": "en-us",
"routing": "0",
"mg": "",
"used_bandwidth": "0.01",
"cached_disk": "a:2:{s:4:\"disk\";a:3:{s:4:\"Used\";i:776044;s:9:\"Available\";i:1190036;s:4:\"Use%\";d:39.469999999999998863131622783839702606201171875;}s:5:\"inode\";a:4:{s:6:\"Inodes\";i:122880;s:5:\"IUsed\";i:21323;s:5:\"IFree\";i:101557;s:4:\"Use%\";d:17.35000000000000142108547152020037174224853515625;}}",
"webuzo": "0",
"disable_ebtables": "0",
"install_xentools": "0",
"admin_managed": "0",
"rdp": "0",
"topology_sockets": "0",
"topology_cores": "0",
"topology_threads": "0",
"mac": "00:16:3e:5f:cd:48",
"notes": null,
"disable_nw_config": "0",
"locked": "",
"openvz_features": "",
"speed_cap": "",
"numa": "0",
"bpid": "0",
"bserid": "0",
"timezone": null,
"usbdevice": "",
"server_name": "localhost",
"email": "tt@rrr.com",
"pid": "0",
"type": "0",
"os_distro": "centos",
"ips": {
"2": "8.8.8.1"
}
}
}