Download RDP File


Updated: July 10, 2015

The Download RDP file operation retrieves the Remote Desktop Protocol configuration file from the specified Virtual Machine.

The Download RDP file request may be specified as follows. Replace <subscription-id> with the subscription ID, <cloudservice-name> with the name of the cloud service, <deployment-name> with the name of the deployment, and <roleinstance-name> the name of the Virtual Machine.


Request URI


URI Parameter



Required. Specifies that the file to retrieve is an RDP file.

The following table describes the request headers.

Request Header



Required. Specifies the version of the operation to use for this request. This header should be set to 2012-03-01 or higher.

The response includes an HTTP status code, a set of response headers, and a response body.

A successful operation returns status code 200 (OK).

The response for this operation includes the following headers. The response may also include additional standard HTTP headers.

Response Header



A value that uniquely identifies a request made against the management service.

The response body returned by the Download RDP file operation is a Remote Desktop Protocol (.rdp) file that can be used to establish a remote desktop session to the Virtual Machine.