Retrieves the content of a .rdp file that provides remote desktop access to the specified VM. An .rdp file comprising the returned content opens a remote desktop session to the VM from a Windows machine. It can also be used on Linux with FreeRDP or on Mac with Microsoft Remote Access.
Request Path
GET /api/v3/vms/actions/getremoteaccessfile?vmId={VmID}VM123ABC&desktopWidth={desktopWidth}&desktopHeight={desktopHeight}
Request Payload
None
Parameters
{VmID} |
The ID of the VM. To retrieve the IDs of all VMs in an environment, use GET /api/v3/envs/actions/getextended. |
{desktopHeight} |
The height resolution of the remote access session, in pixels. |
{desktopWidth} |
The width resolution of the remote access session, in pixels. |
Response Example
{
"rdpFileContent": "username:s:shrpnt\\administrator\r\nfull address:s:uvo1wbqnjqlfnx40fhq.vm.cld.dev\r\ngatewayusagemethod:i:4\r\naudiomode:i:0\r\nredirectprinters:i:1\r\nredirectsmartcards:i:1\r\nredirectclipboard:i:1\r\nredirectposdevices:i:0\r\nredirectdirectx:i:1\r\nauthentication level:i:2\r\nprompt for credentials:i:0\r\nnegotiate security layer:i:1\r\ndisable menu anims:i:1\r\ndisable themes:i:0\r\ndisable cursor setting:i:0\r\nconnection type:i:2\r\ndisable wallpaper:i:1\r\nallow font smoothing:i:0\r\nallow desktop composition:i:0\r\nvideoplaybackmode:i:1\r\ncompression:i:1\r\nscreen mode id:i:2\r\ndesktopwidth:i:\r\ndesktopheight:i:\r\n",
"clearTextPassword": "Jc9Rvp0093"
}
Response Property Notes
rdpFileContent |
The content of .rdp file. |
clearTextPassword |
The password required to access the VM. |