接口接口:RetryPolicy

重试配置。部分覆盖时,未设置的字段继承客户端或 SDK 默认值。

属性

apiConnectionError

ts
readonly apiConnectionError: boolean;

是否重试连接失败,包括被中断的响应体(APIConnectionError)。默认值:true。


apiTimeoutError

ts
readonly apiTimeoutError: boolean;

是否重试 APITimeoutError。默认值:true。


backoffInitialMs

ts
readonly backoffInitialMs: number;

首次退避延迟(毫秒),逐次翻倍直至 backoffMaxMs。默认值:500。


backoffJitter

ts
readonly backoffJitter: number;

从每个退避延迟中随机扣除的比例,取值从 0 到 1。默认值:0.25。


backoffMaxMs

ts
readonly backoffMaxMs: number;

最大退避延迟(毫秒)。默认值:5000。


httpStatuses

ts
readonly httpStatuses: ReadonlySet<number>;

要重试的 HTTP 状态码。默认值:408、429 和 500–599。


maxRetries

ts
readonly maxRetries: number;

初次尝试之后的最大重试次数;0 表示禁用重试。默认值:2。


maxRetryAfterMs

ts
readonly maxRetryAfterMs: number;

服务器重试延迟的上限(毫秒);更长的延迟将改用退避。默认值:60000。


respectRetryAfter

ts
readonly respectRetryAfter: boolean;

遵循 Retry-After 和 retry-after-ms,上限为 maxRetryAfterMs。默认值:true。