取服务器授权密钥

  1. 可通过AuxEsxi管理控制台：设置->系统设置获得SKEY

  2. 可通过服务端(AuxEsxiServer)根目录/conf/server.conf配置文件获得SKEY


公共参数

公共参数是每个请求必须携带的参数。

参数类型是否必填最大长度描述示例值
TimestampString是20

当前请求时间，默认应许与服务器时间误差1分

钟不需要验证误差可通过配置文件关闭

2018-01-01 20:00:00
SignMethodString是3固定：MD5MD5
SignNonceString是32

签名唯一随机数。用于防止网络重放攻

击建议您每一次请求都使用不同的随机数，推荐使用唯一UUID，10-32个字符以内

3455676AFV7435
SignString是32签名结果，注意数据签名时，不要把此参数作为数据签名80628a229091aad3085675689c6d8eaa


拼接签名字符串

1、 对公共参数名按字母升序排序, 得到：

  • SignMethod: "MD5"

  • SignNonce: "3455676AFV7435"

  • Timestamp: "2018-01-01 20:00:00"


将上一步排序好的请求参数格式化成“参数名”=“参数值”的形式，使用urlencode编码后，将"+"，"*"，"%7E"做替换即满足ECS API规定的编码规范。

SignMethod%3DMD5%26SignNonce%3D3455676AFV7435%26Timestamp%3D2018-01-01%2020%3A00%3A00

注意：urlencode编码后请确认空格是否为%20，如果不是请将"+"替换为%20


计算签名

假设您的Skey为“99806c73a2eefa1e7577f9a2bcd86609”将上一步拼接好的字符串再次进行拼接

SignMethod%3DMD5%26SignNonce%3D3455676AFV7435%26Timestamp%3D2018-01-01%2020%3A00%3A00&Skey=99806c73a2eefa1e7577f9a2bcd86609


计算签名结果为：Sign=fdd716380f74cab6f7866d95dc369fa9

注意：签名结果统一使用小写字母


请求删除虚拟机示例

拼接URL

http://127.0.0.1/api/vm/delete?vmid=1&SignNonce=MD5&SignNonce=3455676AFV7435&Timestamp=2018-01-01%2020:00:00&Sign=fdd716380f74cab6f7866d95dc369fa9