To send an Elastic Desktop Service (EDS) API request, you must send an HTTP or HTTPS GET request to the EDS endpoint. You must add the request parameters that correspond to the API operation being called. After you call the API operation, the system returns a response. The request and response are encoded in UTF-8.

Request syntax

EDS API operations use the RPC protocol. You can call Elastic Desktop Service API operations by sending HTTP or HTTPS GET requests.

Use the following request syntax:
https://Endpoint/?Action=xx&Parameters
where:
  • https: the protocol used to transmit the request.
  • Endpoint: the endpoint of the EDS API is ecd.[RegionId].aliyuncs.com.
  • Action: the name of the operation being performed. For example, to query the detailed information about a cloud desktop, you must set the Action parameter to DescribeDesktops.
  • Parameters: the request parameters for the operation. Separate multiple parameters by using ampersands (&).

    Request parameters include both common parameters and operation-specific parameters. Common parameters are used for all EDS API calls regardless of the operation.

Sample requests

Note The following sample request demonstrates only sample values. Perform URL encoding on requests in actual operations.
https://ecd.cn-hangzhou.aliyuncs.com/?Action=DescribeDesktops
&MaxResults=10
&DesktopId.1=ecd-gx2x1dhsmucyy****
...