当通过调用创建实例接口在ECS中创建云服务器时,如果遇到了请求超时或服务器内部错误时,客户端可能会尝试重发请求,这时客户端可以通过提供可选参数ClientToken
避免服务器创建出比预期要多的实例,也就是通过提供ClientToken
参数保证请求的幂等性。ClientToken
是一个由客户端生成的唯一的、大小写敏感、不超过64个ASCII字符的字符串。
如果用户使用同一个ClientToken
值调用创建实例接口,则服务端会返回相同的请求结果,包含相同的InstanceId
。因此用户在遇到错误进行重试的时候,可以通过提供相同的ClientToken
值,来确保ECS只创建一个实例,并得到这个实例的InstanceId
。
如果用户提供了一个已经使用过的ClientToken
,但其他请求参数不同,则ECS会返回IdempotentParameterMismatch
的错误代码。但需要注意的是,SignatureNonce
、Timestamp
和Signature
参数在重试时是需要变化的,因为ECS使用SignatureNonce
来防止重放攻击,使用Timestamp
来标记每次请求时间,所以再次请求必须提供不同的SignatureNonce
和Timestamp
参数值,这同时也会导致Signature
值的变化。
通常,客户端只需要在500(InternalErrorInternalError
)或503(ServiceUnavailable
)错误、或者无法得到响应结果的情况下进行重试操作。返回结果是200时,重试可以得到上次相同的结果,但不会对服务端状态带来任何影响。而对4xx的返回错误,除非提示信息里明确出现“try it later”,通常重试也是不能成功的。
发布者:佚, 佚名,转转请注明出处:https://www.cms2.cn/aliyun/1814.html