跳转到内容
Last updated

端点重试与完成矩阵

已记录的 212 个操作每一个都有重试、幂等与完成策略。策略由 OpenAPI 契约保守推导。端点专属的业务错误码只在操作说明中明确记录时才列出,绝不臆造。此外每个操作都适用通用错误契约。

对于会改变状态的操作,HTTP 超时意味着结果未知,并不等于操作失败。重试前请先查询当前状态。

机器可读的来源是操作行为清单

按产品分的矩阵

产品操作数含端点专属错误码矩阵
Browser5319Browser
Cloud Phone10950Cloud Phone
Cloud Storage2412Cloud Storage
Shared Resources2612Shared Resources

如何读一条策略

策略含义
可带上限的指数退避与抖动安全重试。只读操作。重复执行不改变资源状态。
超时或传输失败后,先查询当前状态再重试。操作可能已经生效。再次发送前请先读取资源。
不要自动重试;先查询资源、上传或任务是否已创建。该操作会创建对象且没有幂等键,盲目重试可能产生重复。
除非端点专属文档说明安全,否则不要自动重试。契约信息不足以归类该操作。按不安全对待。

生成覆盖:212 个操作;93 个有端点专属的已记录业务码,119 个目前依赖通用错误契约。