请求结构
阿里云ECS API支持基于URL发起HTTP/HTTPS GET请求。请求参数需要包含在URL中。本文列举了GET请求中的结构解释,并提供了ECS的服务接入地址(Endpoint)。
结构示例
以下为CreateSnapshot一条未编码的URL请求示例:
https://ecs.aliyuncs.com/?Action=CreateSnapshot
&DiskId=d-28m5zbu**
&<公共请求参数>
https
指定了请求通信协议。ecs.aliyuncs.com
指定了ECS的服务接入地址(Endpoint)。Action=CreateSnapshot
指定了要调用的API,DiskId=d-28m5zbu**
是CreateSnapshot规定的参数。<公共请求参数>
是系统规定的公共参数。
通信协议
支持HTTP或HTTPS协议请求通信。为了获得更高的安全性,推荐您使用HTTPS协议发送请求。
涉及敏感数据时,如用户密码和SSH密钥对,推荐使用HTTPS协议。例如,在CreateInstance中指定Password
参数时。
接入地址
ECS API的服务接入地址,参见以下表格。为减少网络延时,建议您根据业务调用来源配置接入地址。
地域(部署位置) | 接入地址 |
---|---|
中心 | ecs.aliyuncs.com |
华北3(张家口) | ecs.cn-zhangjiakou.aliyuncs.com |
华北5(呼和浩特) | ecs.cn-huhehaote.aliyuncs.com |
日本(东京) | ecs.ap-northeast-1.aliyuncs.com |
澳大利亚(悉尼) | ecs.ap-southeast-2.aliyuncs.com |
马来西亚(吉隆坡) | ecs.ap-southeast-3.aliyuncs.com |
印度尼西亚(雅加达) | ecs.ap-southeast-5.aliyuncs.com |
印度(孟买) | ecs.ap-south-1.aliyuncs.com |
阿联酋(迪拜) | ecs.me-east-1.aliyuncs.com |
德国(法兰克福) | ecs.eu-central-1.aliyuncs.com |
英国(伦敦) | ecs.eu-west-1.aliyuncs.com |
下表中的接入地址已通过虚拟网络和高速通道加速,减少了因国界或地区通信转发带来的网络延时。
地域(部署位置) | 接入地址 |
---|---|
中心(美国硅谷) | ecs.us-west-1.aliyuncs.com |
中心(美国弗吉尼亚) | ecs.us-east-1.aliyuncs.com |
中心(中国香港) | ecs.cn-hongkong.aliyuncs.com |
中心(新加坡) | ecs.ap-southeast-1.aliyuncs.com |
说明 由于云服务器ECS提供的接入地址(Endpoint)为公网服务地址,当您的ECS实例没有分配公网带宽或者不存在公网IP地址时,无法使用阿里云CLI或者SDK等工具发起API请求。如果您的请求端为专有网络VPC类型的无公网访问的ECS实例,并有内网调用需求,请参见如何通过内网调用API。
请求参数
您需要通过Action
参数指定目标操作,例如Action=StartInstance。还需要指定接口的其他参数以及公共请求参数,详情请参见公共请求参数。
字符编码
请求及返回结果都使用UTF-8
字符集编码。
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论