您在调用弹性伸缩的API时,如果发生请求超时或服务器内部错误,客户端可能会尝试重发请求。您可以在请求中设置ClientToken参数避免多次重试带来重复操作的问题。
什么是幂等性
在数学计算或者计算机科学中,幂等性(idempotence)是指相同操作或资源在一次或多次请求中具有同样效果的作用。幂等性是在分布式系统设计中具有十分重要的地位。
保证幂等性
通常情况下,客户端只需要在500(InternalError
)或503(ServiceUnavailable
)错误,或者无法获取响应结果时重试。使用阿里云弹性伸缩的API,您可以从客户端生成一个参数值不超过64个的ASCII字符,并将值赋予ClientToken,保证重试请求的幂等性。
ClientToken详解
ClientToken是一个由客户端生成的唯一的、区分大小写、不超过64个ASCII字符的字符串。例如,
ClientToken=123e4567-e89b-12d3-a456-42665544****
。如果您提供了一个已经使用过的ClientToken,但其他请求参数有变化,则弹性伸缩会返回
IdempotentParameterMismatch
的错误代码。说明参数SignatureNonce、Timestamp和Signature在重试时是需要变化的。具体原因是弹性伸缩使用SignatureNonce防止重放攻击,使用Timestamp标记每次请求时间。所以再次请求必须提供不同的SignatureNonce和Timestamp参数值,同时也会导致Signature值的变化。
添加了ClientToken参数后:
返回结果是200 HTTPCode时,重试后客户端可以得到与上次相同的结果,但对您的服务端状态没有影响。
返回结果是4xx HTTPCode时,如果错误信息没有表明
try it later
类似的信息,重试不会成功。您需要根据错误信息排查问题后再重试请求。
幂等请求示例
以CreateScalingGroup创建一个伸缩组为例,如果您使用同一个ClientToken值,其他请求参数相同时,则服务端会返回相同的请求结果,只会产生一个ScalingGroupId。
http(s)://ess.aliyuncs.com/?Action=CreateScalingGroup
&ScalingGroupName=scalinggroup****
&InstanceId=i-28wt4****
&RegionId=cn-qingdao
&MinSize=2
&MaxSize=20
&DefaultCooldown=300
.......
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&<公共请求参数>
API列表
以下为部分包含了ClientToken参数的API,供您参考。具体哪些API支持ClientToken参数请以各API文档为准,此处不一一列举。
创建一个伸缩组:CreateScalingGroup
创建一个ECS类型的伸缩配置:CreateScalingConfiguration
从一个伸缩组删除一台或多台ECS实例:RemoveInstances
执行一条伸缩规则:ExecuteScalingRule
添加一个或多个RDS实例:AttachDBInstances
从伸缩组添加一个或多个负载均衡服务器组:AttachServerGroups
添加一个或多个负载均衡实例:AttachLoadBalancers
向伸缩组添加一个或多个ALB服务器组:AttachAlbServerGroups
添加负载均衡实例下的一个或者多个虚拟服务器组:AttachVServerGroups