全部产品
Search

搜索本产品

    弹性伸缩：如何保证幂等性

    文档中心

    弹性伸缩：如何保证幂等性

    更新时间：Nov 01, 2023

    您在调用弹性伸缩的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文档为准，此处不一一列举。