介绍产品调用API请求的请求和返回模式。

请求结构

云桌面的API是RPC风格,您可以通过发送HTTP GET请求调用云桌面API。

其请求结构如下:
http://Endpoint/?Action=xx&Parameters
其中:
  • Endpoint: 云桌面API的服务接入地址为gws.aliyuncs.com
  • Action:要执行的操作,如调用DescribeClusters查询集群。
  • Version:要使用的API版本,云桌面的API版本是2019-06-18
  • Parameters:请求参数,每个参数之间用“&”分隔。

    请求参数由公共请求参数和API自定义参数组成。公共参数中包含API版本号、身份验证等信息,详情请参见公共参数

下面是一个调用DescribeClusters接口查询已创建的集群:
说明 为了便于用户查看,本文档中的示例都做了格式化处理。
https://gws.aliyuncs.com/?Action=DescribeClusters
&Format=xml
&Version=2019-06-18
&Signature=xxxx%xxxx%3D
&SignatureMethod=HMAC-SHA1
&SignatureNonce=15215528852396
&SignatureVersion=1.0
&AccessKeyId=key-test
&TimeStamp=2019-09-01T12:00:00Z
…