Format

Method	GET
URL	/hosts/$HOST_ID
Request contents	Empty
Successful answer	HostInfo Object
Non-successful answer	ErrorMessage Object
Unexpected error	HTTP 500

HostInfo Object

Schema

host_id	String	Host unique identifier
hypervisor	String	Hypervisor's type and version
cpu_type	String	Host's CPU type
description	String	User defined field
physical_cores	String	Host's number of physical cores
cpu_overcommit	Float	Virtual CPU overcommit multiplier
vcpus_total	String	Total number of vCPUs on this Host (physical_cores * cpu_overcommit)
vcpus_in_use	String	Number of vCPUs currently in use by some Guest
vcpus_reserved	String	Number of vCPUs currently reserved by some Pool
physical_ram	String	Host's physical RAM (GB)
ram_overcommit	String	Virtual RAM overcommit multiplier
vram_total	String	Total amount of vRAM on this Host (physical_ram * ram_overcommit)
vram_in_use	String	Amount of vRAM currently in use by some Guest
vram_reserved	String	Amount of vRAM currently reserved by some Pool
host_address	String	Host's management network address
host_vdi_address	String	Host's VDI access network address. If empty, host_address will be used
desired_state	String	Host's desired state. Either "stopped" or "running"
current_state	String	Host's current state. Either "unknown", "unavailable", "stopped", "running" or "incompatible"
error_msg	String	Result from latest Agent pooling.
phys_iface_list	PhysIfaceInfo Array	List of all physical network interfaces on this Host
bonding_iface_list	BondIfaceInfo Array	List of all network bondings on this Host
bridge_iface_list	BridgeIfaceInfo Array	List of all network bridges on this Host
vlan_iface_list	VlanIfaceInfo Array	List of all native VLAN interfaces on this Host
pools_info	HostPoolInfo Array	List of all Pools which have reserved resources from this Host
guests_info	HostGuestInfo Array	List of all Guests which are currently using resources from this Host

JSON sample

{
    "hypervisor": "flexVDI Agent v2.2.18",
    "desired_state": "running",
    "vlan_iface_list": [],
    "current_state": "running",
    "vcpus_total": "48",
    "description": "",
    "vram_reserved": "84",
    "cpu_overcommit": 2.0,
    "host_address": "10.111.8.2",
    "vcpus_reserved": "42",
    "host_vdi_address": "demo01.flexvdi.com",
    "ram_overcommit": 1.5,
    "bonding_iface_list": [],
    "physical_ram": "62",
    "host_id": "flexdev01",
    "vcpus_in_use": "21",
    "vram_in_use": "25",
    "error_msg": "The operation was successfully completed.",
    "phys_iface_list": [{
        "netmask": "None",
        "gateway": "None",
        "hwaddr": "None",
        "address": "None",
        "iface": "eth0"
    }, {
        "netmask": "None",
        "gateway": "None",
        "hwaddr": "None",
        "address": "None",
        "iface": "eth1"
    }],
    "bridge_iface_list": [{
        "netmask": "255.255.255.0",
        "gateway": "None",
        "address": "192.168.104.1",
        "slave_list": [],
        "iface": "virbr1"
    }, {
        "netmask": "255.255.255.0",
        "gateway": "10.111.8.1",
        "address": "10.111.8.2",
        "slave_list": ["eth0"],
        "iface": "virbr0"
    }],
    "physical_cores": "24",
    "vram_total": "93",
    "cpu_type": "Intel(R) Xeon(R) CPU E5-2420 0 @ 1.90GHz",
    "guests_info": [{
        "guest_id": "opensuse421_public-volatile-e30ca1bb",
        "pool_id": "demo_public",
        "vcpus": "2",
        "vram": "2"
    }, {
        "guest_id": "opensuse421_public-volatile-787c3d17",
        "pool_id": "demo_public",
        "vcpus": "2",
        "vram": "2"
    }, {
        "guest_id": "windowsXP_public-volatile-2fc460a9",
        "pool_id": "demo_public",
        "vcpus": "1",
        "vram": "1"
    }, {
        "guest_id": "voidlinux_slp",
        "pool_id": "demo_private",
        "vcpus": "2",
        "vram": "4"
    }, {
        "guest_id": "opensuse421_public-volatile-41b8354a",
        "pool_id": "demo_public",
        "vcpus": "2",
        "vram": "2"
    }, {
        "guest_id": "windows7_020216-volatile-ad817d46",
        "pool_id": "demo_public",
        "vcpus": "2",
        "vram": "2"
    }, {
        "guest_id": "webportal_devel",
        "pool_id": "services",
        "vcpus": "2",
        "vram": "4"
    }, {
        "guest_id": "windows7_020216-volatile-687d354a",
        "pool_id": "demo_public",
        "vcpus": "2",
        "vram": "2"
    }, {
        "guest_id": "windows7_020216-volatile-657536a6",
        "pool_id": "demo_public",
        "vcpus": "2",
        "vram": "2"
    }, {
        "guest_id": "windowsXP_public-volatile-43d4e04c",
        "pool_id": "demo_public",
        "vcpus": "1",
        "vram": "1"
    }, {
        "guest_id": "windowsXP_public-volatile-19a07939",
        "pool_id": "demo_public",
        "vcpus": "1",
        "vram": "1"
    }, {
        "guest_id": "corus_demo",
        "pool_id": "services",
        "vcpus": "2",
        "vram": "2"
    }],
    "pools_info": [{
        "vram_reserved": "60",
        "vcpus_reserved": "30",
        "vcpus_in_use": "15",
        "vram_in_use": "15",
        "pool_id": "demo_public"
    }, {
        "vram_reserved": "8",
        "vcpus_reserved": "4",
        "vcpus_in_use": "4",
        "vram_in_use": "6",
        "pool_id": "services"
    }, {
        "vram_reserved": "4",
        "vcpus_reserved": "2",
        "vcpus_in_use": "0",
        "vram_in_use": "0",
        "pool_id": "templates"
    }, {
        "vram_reserved": "12",
        "vcpus_reserved": "6",
        "vcpus_in_use": "2",
        "vram_in_use": "4",
        "pool_id": "demo_private"
    }]
}

PhysIfaceInfo Object

Schema

iface	String	Interface name on the Host
hwaddr	String	Interface MAC address, or "None", if not present
address	String	Interface IP address, or "None", if not present
netmask	String	Interface network mask, or "None", if not present
gateway	String	Interface network gateway, or "None", if not present

JSON example

{
    "netmask": "None",
    "gateway": "None",
    "hwaddr": "None",
    "address": "None",
    "iface": "eth0"
}

BondIfaceInfo Object

Schema

iface	String	Interface name on the Host
address	String	Interface IP address, or "None", if not present
netmask	String	Interface network mask, or "None", if not present
gateway	String	Interface network gateway, or "None", if not present
slave_list	String Array	List of physical interfaces associated to this bonding

JSON example

{
    "netmask": "None",
    "gateway": "None",
    "address": "None",
    "slave_list": ["eth0", "eth1"],
    "iface": "bond0"
}

BridgeIfaceInfo Object

Esquema de datos

iface	String	Interface name on the Host
address	String	Interface IP address, or "None", if not present
netmask	String	Interface network mask, or "None", if not present
gateway	String	Interface network gateway, or "None", if not present
slave_list	String Array	List of physical interfaces associated to this bridge

JSON example

{
    "netmask": "255.255.255.0",
    "gateway": "192.168.1.1",
    "address": "192.168.1.10",
    "slave_list": ["bond0"],
    "iface": "virbr0"
}

VlanIfaceInfo Object

Schema

iface	String	Interface name on the Host
address	String	Interface IP address, or "None", if not present
netmask	String	Interface network mask, or "None", if not present
gateway	String	Interface network gateway, or "None", if not present
vlan	String	VLAN's ID

JSON sample

{
    "netmask": "255.255.255.0",
    "gateway": "192.168.1.1",
    "address": "192.168.1.10",
    "vlan": "234",
    "iface": "vlan234"
}

HostPoolInfo Object

Schema

pool_id	String	Pool's unique identifier
vcpus_reserved	String	Number of vCPUs reserved from this Pool
vcpus_in_use	String	Number de vCPUs reserved from this Pool, currently in use
vram_reserved	String	Amount of vRAM reserved from this Pool
vram_in_use	String	Amount de vRAM reserved from this Pool, currently in use

{
    "vram_reserved": "60",
    "vcpus_reserved": "30",
    "vcpus_in_use": "15",
    "vram_in_use": "15",
    "pool_id": "demo_public"
}

HostGuestInfo Object

Schema

guest_id	String	Guest's unique identifier
pool_id	String	Unique identifier for Guest's associated Pool
vcpus	String	Number of vCPUs currently in use by this Guest
vram	String	Amount of vRAM currently in use by this Guest

{
    "guest_id": "corus_demo",
    "pool_id": "services",
    "vcpus": "2",
    "vram": "2"
}