ECS API

一、API调用方式

➢对ECS API接口调用是通过向ECS API的服务端地址发送HTTP GET请求,并按照接口说明在请求

中加入相应请求参数来完成的;根据请求的处理情况,系统会返回处理结果。

➢请求结构

•服务地址: ECS API的服务接入地址为: ecs.aliyuncs .com

•通信协议:支持通过HTTP或HTTPS通道进行请求通信。推荐使用HTTPS通道发送请求。

•请求方法:支持HTTP GET方法发送请求,这种方式下请求参数需要包含在请求的URL中。

•请求参数:每个请求都需要指定要执行的操作,即Action参数(例如StartInstance )以及每个操作都需要包含的公共请求参数和指定操作所特有的请求参数。

•字符编码:请求及返回结果都使用UTF-8字符集进行编码

二、API签名机制

➢ECS服务会对每个访问的请求进行身份验证,所以无论使用HTTP还是HTTPS协议提交请
求,都需要在请求中包含签名( Signature )信息。
➢ECS通过使用Access Key ID和Access Key Secret进行对称加密的方法来验证请求的发送

者身份。

ECS API详细介绍

实例相关接口

创建实例，启动实例，停止实例，重启实例，删除实例
修改实例属性
查询实例状态(查询实例列表)
查询实例信息
将实例加入安全组，将实例移出安全组

磁盘相关接口

创建磁盘，查询磁盘，挂载磁盘，卸载磁盘
修改磁盘属性，删除磁盘
重新初始化磁盘，回滚磁盘，更换系统盘

快照相关接口

创建快照，删除快照
查询快照列表
设置自动快照策略，查询自动快照策略

镜像相关接口

查询可用镜像
创建自定义镜像
删除自定义镜像

网络相关接口

分配公网IP地址

安全组相关接口

创建安全组，授权安全组，权限查询安全组规则
查询安全组列表，撤销安全组规则，删除安全组

地域相关接口

查询可用地域列表
查询可用区

监控相关接口

查看云服务器实例的监控信息

其他接口

查询实例资源规格列表

三、ECS API示例：通过API重启指定的实例

API相关信息：

➢只有状态为Running的实例才能进行此操作

➢接口调用成功后实例进入Starting状态

➢支持强制重启，强制重启等同于传统服务器的断电重启，可能丢失实例操作系统中未写入磁盘的数据

➢被安全控制在实例的OperationLocks中标记了"LockReason":"security "的锁定状态时，不能重启实例