Get Virtual Machine
Request
URI
GET
https://{api_host}/dt-rest/v100/infrastructure/manager/vm
COPY
Query Parameters
string
vmid
Required
vmid
string
pid
Required
pid
Responses
200
successful operation
Returns DtVirtualMachine of type(s) */*
{
"DtVirtualMachineState": "string",
"type": "string",
"description": "string",
"vmId": "string",
"numCPUs": 0,
"patternId": "string",
"templateId": "string",
"vmPath": "string",
"inventoryPath": "string",
"ipAddress": "string",
"externalIpAddress": "string",
"refId": "string",
"vmpowerState": "string",
"vmlifeState": "string",
"vmlifeStateDate": "string",
"threeDEnabled": false,
"hotplugEnabled": false,
"vmhardwareVersion": "string",
"networkId": "string",
"daaSAgentVersion": "string",
"daaSAgentState": "string",
"vmwareToolsState": "string",
"guestOS": "string",
"computePoolId": "string",
"memorySizeMB": 0,
"goldPatternVersion": 0,
"powerOnDate": "string",
"sealDate": "string",
"poolName": "string",
"macAddress": "string",
"desktopManagerName": "string",
"viewAgentVersion": "string",
"dnsName": "string",
"viewAgentPaired": false,
"agentPairingAcknowledged": false,
"allocateState": "string",
"resyncState": "string",
"customizationState": "string",
"agentErrorCode": "string",
"sessionAllocationState": "string",
"rectify": false,
"name": "string",
"id": "string",
"links": [
{
"href": "string",
"rel": "string",
"deprecated": false,
"name": "string",
"method": "string"
}
]
}
string
DtVirtualMachineState
Required
Virtual Machine State
Possible values are : Success, Pending, Failed, Incomplete,
string
type
Optional
type
string
description
Optional
description
string
vmId
Optional
vmId
integer As int32 As int32
numCPUs
Optional
numCPUs
string
patternId
Optional
patternId
string
templateId
Optional
templateId
string
vmPath
Optional
vmPath
string
inventoryPath
Optional
inventoryPath
string
ipAddress
Optional
ipAddress
string
externalIpAddress
Optional
externalIpAddress
string
refId
Optional
refId
string
vmpowerState
Optional
vmpowerState
Possible values are : POWERED_ON, POWERED_OFF, SUSPENDED, POWER_STATE_POWERING_ON, POWER_STATE_POWERING_OFF, POWER_STATE_RESETTING, POWER_STATE_SUSPENDING,
string
vmlifeState
Optional
vmlifeState
Possible values are : CLONING, CLONE_FAILED, PREPARING, JOINING_DOMAIN, IN_DOMAIN, NOT_IN_DOMAIN, STARTING, READY, UNKNOWN, OFF, DESTROYING, INCOMPLETE,
string As date-time As date-time
vmlifeStateDate
Optional
vmlifeStateDate
boolean
threeDEnabled
Optional
threeDEnabled
boolean
hotplugEnabled
Optional
hotplugEnabled
string
vmhardwareVersion
Optional
vmhardwareVersion
string
networkId
Optional
networkId
string
daaSAgentVersion
Optional
daaSAgentVersion
string
daaSAgentState
Optional
daaSAgentState
Possible values are : ACTIVE, INACTIVE, UNKNOWN, NOT_PAIRED, DISABLED, DRAINING, DRAINING_UNTIL_RESTART,
string
vmwareToolsState
Optional
vmwareToolsState
Possible values are : UNKNOWN, NOT_RUNNING, OUT_OF_DATE, NOT_INSTALLED, OK,
string
guestOS
Optional
guestOS
Possible values are : LINUX_32, LINUX_64, OTHER, UBUNTU_32, UBUNTU_64, WIN_XP, WIN_VISTA, WIN_7, WIN_7_64, WIN_8, WIN_8_64, WIN_10, WIN_10_64, WIN_SERVER_2K8R2_64, WIN_SERVER_2K12_64, DAAS_APPLIANCE, WIN_SERVER_2K16_64, WIN_SERVER_2K19_64, WINDOWS, WIN_10_WVD_64,
string
computePoolId
Optional
computePoolId
integer As int32 As int32
memorySizeMB
Optional
memorySizeMB
integer As int64 As int64
goldPatternVersion
Optional
goldPatternVersion
string As date-time As date-time
powerOnDate
Optional
powerOnDate
string As date-time As date-time
sealDate
Optional
sealDate
string
poolName
Optional
poolName
string
macAddress
Optional
macAddress
string
desktopManagerName
Optional
desktopManagerName
string
viewAgentVersion
Optional
viewAgentVersion
string
dnsName
Optional
dnsName
boolean
viewAgentPaired
Optional
viewAgentPaired
boolean
agentPairingAcknowledged
Optional
agentPairingAcknowledged
string
allocateState
Optional
allocateState
string
resyncState
Optional
resyncState
string
customizationState
Optional
customizationState
string
agentErrorCode
Optional
agentErrorCode
string
sessionAllocationState
Optional
sessionAllocationState
boolean
rectify
Optional
rectify
string
name
Optional
name
string
id
Optional
id
Dt Infrastructure Manager Operations
POST
Assign Host Manager To Element
PUT
Assign Network To Desktop Manager
POST
Assign Storage Config To Element
POST
Assign Vmgr To Desktop Manager
PUT
Associate D Cto Vmgr
GET
Check Slony
PUT
Create Account Credential
POST
Create Data Center
POST
Create Desktop Model
POST
Create Desktop Model Definition
POST
Create Network
POST
Create Nginx Config For All Desktop Purpose H Mgrs
POST
Create Or Update Desktop Manager DM Quota
POST
Create Or Update Remote Protocol Quota
POST
Create Or Update Session Quota
POST
Create Or Update Template Quota
POST
Create Reservation For Appliances
POST
Create Standard Capacity
POST
Create Storage Config
POST
Discover Hypervisor Manager
POST
Discover Hypervisor Manager By Address With Cert Validation
POST
Discover Hypervisor Manager With Cert Validation
POST
Discover New Storage System
POST
Discover Storage System
GET
Enabled Desktop Model Definitions
GET
Generate Public Key
GET
Get Data Centers
GET
Get Data Stores By DC And Element Id
GET
Get Desktop Model Definitions
GET
Get Desktop Model Quotas
GET
Get Desktop Models
GET
Get Desktop Models For Std Capacity
GET
Get Enabled Standard Capacities
GET
Get Hypervisor Managers
POST
Get Import Vm Specifications
GET
Get Supported Links
GET
Get Tenant Desktop Managers
GET
Get Tenant Desktop Managers By Data Center
GET
Get Tenant Networks
GET
Get VGPU Profiles
GET
Get Virtual Machine
GET
Get Virtual Machines
POST
Import VM From File Share
POST
Purge Recycle Pool
POST
Refresh Dynamic Pool
POST
Remove Storage Config
POST
Remove Storage System
GET
Retrieve All Remote Protocol Quotas
GET
Retrieve All Storage Configs
GET
Retrieve All Storage Systems
GET
Retrieve Internal Tenant Networks
GET
Retrieve Session Quota For Tenant
GET
Retrieve Storage Configs For Storage System
GET
Retrieve Template Quota For Tenant
POST
Save Resource Credentials For Cluster
POST
Scan For Hot Patch
POST
Set Appliance Template
POST
Unassign Host Manager From Element
PUT
Unassign Network From Desktop Manager
POST
Unassign Storage Config From Element
POST
Unassign Vmgr From Desktop Manager
PUT
Update Assign Compute Pool To SP