重试配置。部分覆盖时,未设置的字段继承客户端或 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。