This operation returns a list of virtual machines.
Request
Syntax
GET <webservice>/VM HTTP/1.1
Host: <host name>
Accept: {application/xml | application/json}
Authtoken: <authentication token>
PagingInfo: <page number and number of records>
where <webservice> is the root path used to route the API requests to the Web Server.
For more information, see Available Web Services for REST API.
Request Headers
Name | Description |
---|---|
Host | The host name of the Web Server or Web Console used in the API request. |
Accept | The format of the response. Valid values are: application/xml or application/json. |
Authtoken | The authentication token received after successfully logging on. For details on receiving an authentication token, see Authentication. |
PagingInfo | a,b Where:
|
Response
Response Parameters
Parameter | Description | Element |
---|---|---|
vmHost | The host name for the computer where the source virtual machine or instance resides. | vmStatusInfoList |
vmGuestSpace | The actual space used on the storage volume for the virtual machine, instance, or container. For Linux virtual machines, the Guest Size appears as 0. | vmStatusInfoList |
bkpStartTime | The date and time that the backup of the VM, instance, or container began. Valid values are UNIX-style timestamps (seconds since January 1, 1970). | vmStatusInfoList |
vmStatus | The status of the backup for the VM, instance, or container. | vmStatusInfoList |
vmBackupJob | vmStatusInfoList | |
strOSName | The operating system version for the VM or instance. | vmStatusInfoList |
isDeleted | Indicates whether or not the VM was deleted from the hypervisor. Valid values are true/false. | vmStatusInfoList |
vendor | The hypervisor where the VM is located. | vmStatusInfoList |
osType | The operating system installed on the VM. | vmStatusInfoList |
vmSize | The total space allocated for the virtual machine, calculated as the sum of the maximum disk sizes for all of the hard disks for the virtual machine. | vmStatusInfoList |
vmUsedSpace | The total space occupied on the disk. | vmStatusInfoList |
subclientId | The system-generated ID assigned to the subclient. | vmStatusInfoList |
subclientName | The name of the subclient. | vmStatusInfoList |
bkpEndTime | The date and time that the backup of the VM, instance, or container finished. Valid values are UNIX-style timestamps (seconds since January 1, 1970). | vmStatusInfoList |
vmAgent | The name of the VSA proxy that performed the backup. | vmStatusInfoList |
name | The display name of the VM. | vmStatusInfoList |
vmHardwareVer | The hardware version of the VM. | vmStatusInfoList |
strGUID | The globally unique identifier for the VM client. | vmStatusInfoList |
clientId | The system-generated ID assigned to the virtual machine. | client |
clientName | The name of the virtual machine. | client |
clientId | The system-generated ID assigned to the proxy client. | proxyClient |
clientName | The name of the proxy client. | proxyClient |
clientId | The system-generated ID assigned to the virtualization client. | pseudoClient |
clientName | The name of the virtualization client. | pseudoClient |
Examples
Sample Request
GET <webservice>/VM HTTP/1.1
Host: client.mydomain.com
Accept: application/json
Authtoken: QSDK 38568012f4d1e8ee1841d283a47aa3ba78e124ea58354b5fc6
0f4dab8a63347d05cf5552484dafda3bfa4c5db84e580b1cb37bcf8e65b39f7f
8549a443e6f78a2c7be3f31b3d845e24776c835e498e8e883bb40c46bd15af4f
40ca94e823acedcdd4e9659e74b34a07a85c4586cd2ed914b6dce015874783ef7
68fda78183a4208930954a377f66eb56c8b92cexampl4s437a19317ca6ce7f323
3d5a01aca35dbad93468b833f2cf71010809006a937670adce711ca8be46638e8
Sample Response
{ "totalRecords": 4, "pageNo": 0, "errorMessage": "", "errorCode": 0, "pageSize": 100, "vmStatusInfoList": [ { "vmHost": "172.19.116.30", "vmGuestSpace": 6442642704, "bkpStartTime": 1537826493, "type": 9, "vmStatus": 1, "vmBackupJob": 2159, "strOSName": "CentOS 4/5 or later (64-bit)", "isDeleted": false, "vendor": 1, "osType": 2, "vmSize": 6442642704, "vmUsedSpace": 191889408, "subclientId": 10, "bkpEndTime": 1537826609, "vmAgent": "vkprime", "name": "ty-vm", "vmHardwareVer": "vmx-09", "strGUID": "502d21a1-ae8b-a75e-exam-313ccc60ea03", "subclientName": "replication_api", "client": { "clientId": 4, "clientName": "ty-vm" }, "proxyClient": { "clientId": 2, "clientName": "vkprime" }, "plan": {}, "pseudoClient": { "clientId": 3, "clientName": "vsa-vc65.mycompany.com", "flags": { "disabled": false } } }, { "vmHost": "172.19.110.73", "vmGuestSpace": 11335602176, "bkpStartTime": 1538495626, "type": 9, "vmStatus": 1, "vmBackupJob": 2247, "strOSName": "Microsoft Windows Server 2012 (64-bit)", "isDeleted": true, "vendor": 1, "osType": 1, "vmSize": 42950022432, "vmUsedSpace": 11562647552, "subclientId": 14, "bkpEndTime": 1538496277, "vmAgent": "vkprime", "name": "N3-VM3-test1", "vmHardwareVer": "vmx-11", "strGUID": "502d1699-exam-fdc3-37c9-421vvvv3244a", "subclientName": "no_rep_subclient", "client": { "clientId": 9, "clientName": "N3-VM3-test1" }, "proxyClient": { "clientId": 2, "clientName": "vkprime" }, "plan": {}, "pseudoClient": { "clientId": 3, "clientName": "vsa-vc65.mycompany.com", "flags": { "disabled": false } } } ]
}