Page Comparison

By sending requests to the Virtual Machine endpoint /vm/ you can list, create, update or delete VMs.

List all virtual machines

In order to list all your Virtual Machines you should make a HTTP GET request to the endpoint /vm/, passing of course your access token. You'll get a quick summary of every single virtual machine you have permission to manage in the EIS Virtual Cloud.

Name	Type	Description
uuid	string	128-bit UUID of a virtual machine, represented as a hexademical string. This identifier is used by VirtualCenter to uniquely identify all virtual machine instances, including those that may share the same SMBIOS UUID.
name	string	Virtual Machine name including VSS prefix.
guestFullName	string	This is the full name of the guest operating system for the virtual machine. For example: Windows 2000 Professional.
ipAddress	string	Primary IP address assigned to the guest operating system, if known.
memoryMB	integer	Memory size of the virtual machine, in megabytes.
cpuCount	integer	Number of processors in the virtual machine.
overallStatus	string	Overall alarm status on this node.
powerState	string	The current power state of the virtual machine.
provisionedGB	integer	Sum of Committed and Uncommitted storage.

The following example uses HTTPie to request all Virtual Machine managed by given user without filters:

Code Block

language	py
title	http -a $TK GET https://vss-api.eis.utoronto.ca:8001/v2/vm/
collapse	true

HTTP/1.0 200 OK
Allow: HEAD, POST, OPTIONS, GET
Content-Length: 14498
Content-Type: application/json
Date: Mon, 25 Apr 2016 20:50:35 GMT
Server: Werkzeug/0.11.3 Python/2.7.10
X-RateLimit-Limit: 7200
X-RateLimit-Remaining: 7171
X-RateLimit-Reset: 1461618000
{
    "_links": {
        "api": "https://vss-api.eis.utoronto.ca:8001/v2/", 
        "self": "https://vss-api.eis.utoronto.ca:8001/v2/vm/"
    }, 
    "data": [
        {
            "_links": {
                "self": "http://localhost:5000/v2/vm/50125944-d5e0-248d-0f3c-c499acbeb1ce/"
            }, 
            "cpuCount": 2, 
            "folder": {
                "_links": {
                    "self": "http://localhost:5000/v2/folder/group-v6557"
                }, 
                "moref": "group-v6557", 
                "name": "Swarm", 
                "parent": "Sandbox"
            }, 
            "guestFullName": "Other 3.x Linux (64-bit)", 
            "ipAddress": "128.100.228.72", 
            "memoryMB": 2048, 
            "name": "1604P-docker-node2", 
            "overallStatus": "green", 
            "powerState": "poweredOn", 
            "provisionedGB": 22, 
            "uuid": "50125944-d5e0-248d-0f3c-c499acbeb1ce"
        }
    ], 
    "meta": {
        "count": 22, 
        "time": "1.04441s", 
        "user": "jm"
    }
}

Filters

Filtering VM results

Name	Description
name	Virtual Machine name string to filter VMs
ip	Primary IP address assigned to the Guest operating system.
dns	Hostname of the guest operating system.

Examples

Code Block
// example with

List specific virtual machine info

Some of the attributes will have an object value. Such is the case of the guest, hardware, network, config, vss and guest.

Name	Type	Description
uuid	string	VirtualCenter-specific 128-bit UUID of a virtual machine, represented as a hexademical string. This identifier is used by VirtualCenter to uniquely identify all virtual machine instances, including those that may share the same SMBIOS UUID.
name	string	Virtual Machine name including VSS prefix.
Config	VM Configuration
bootdelay	integer	Delay in milliseconds before starting the boot sequence. The boot delay specifies a time interval between virtual machine power on or restart and the beginning of the boot sequence.
hotaddCPU	boolean	Whether virtual processors can be added while this virtual machine is running.
hotremoveCpu	boolean	Whether virtual processors can be removed while this virtual machine is running.
hotaddMem	boolean	Whether memory can be added while this virtual machine is running.
Folder	Logical Folder
name	string	Immediate folder holding VM
parent	string	Parent folder holding the VM
path	string	Full path to immediate folder
Guest	Guest status and configuration
guestFullName	string	This is the full name of the guest operating system for the virtual machine. For example: Windows 2000 Professional.
guestId	string	Guest operating system configured on a virtual machine.
hostName	string	Hostname of the guest operating system, if known.
ipAddress	string	Primary IP address assigned to the guest operating system, if known.
toolsStatus	string	Current running status of VMware Tools in the guest operating system, if known.
toolsVersion	string	Current version status of VMware Tools in the guest operating system, if known.
Hardware
cpuCount	integer	Number of processors in the virtual machine.
coresPerSocket	integer	Number of cores used to distribute virtual CPUs among sockets in this virtual machine. If the value is unset it implies to numCoresPerSocket = 1.
memoryMB	integer	Memory size of the virtual machine, in megabytes.
numEthernetCards	integer	Number of virtual network adapters.
numVirtualDisks	integer	Number of virtual disks attached to the virtual machine.
devices	string	List of strings holding controllers, cd/dvd, disks and nics configured in the VM
version	string	The version string for this virtual machine.
Storage	Storage summary
provisionedGB	integer	Sum of Committed and Uncommitted storage.
uncommittedGB	integer	Additional storage space, in bytes, potentially used by this virtual machine on all datastores.
committedGB	integer	Total storage space, in bytes, committed to this virtual machine across all datastores.
unsharedGB	integer	Total storage space, in bytes, occupied by the virtual machine across all datastores, that is not shared with any other virtual machine.
Status	Runtime status related attributes
overallStatus	string	Overall alarm status on this node.
powerState	string	The current power state of the virtual machine.
alarms	boolean	Whether the VM has triggered alarms.
bootTime	String	The timestamp when the virtual machine was most recently powered on.
VSS	VSS Management tags
Admin	string	VM admin responsible of this VM.
Inform	string	Informational contacts to be notified.
Requested	string	The timestamp when the virtual machine was requested.
Client	string	Custom client key-value notes.

Version	Old Version 1	New Version 2
Changes made by	JM Lopez	JM Lopez
Saved on	Apr 25, 2016	Apr 25, 2016

Versions Compared

Key

List all virtual machines

Filters

List specific virtual machine info