已记录的 212 个操作每一个都有重试、幂等与完成策略。策略由 OpenAPI 契约保守推导。端点专属的业务错误码只在操作说明中明确记录时才列出,绝不臆造。此外每个操作都适用通用错误契约。
对于会改变状态的操作,HTTP 超时意味着结果未知,并不等于操作失败。重试前请先查询当前状态。
机器可读的来源是操作行为清单。
| 产品 | 操作数 | 含端点专属错误码 | 矩阵 |
|---|---|---|---|
| Browser | 53 | 19 | Browser |
| Cloud Phone | 109 | 50 | Cloud Phone |
| Cloud Storage | 24 | 12 | Cloud Storage |
| Shared Resources | 26 | 12 | Shared Resources |
| 策略 | 含义 |
|---|---|
| 可带上限的指数退避与抖动安全重试。 | 只读操作。重复执行不改变资源状态。 |
| 超时或传输失败后,先查询当前状态再重试。 | 操作可能已经生效。再次发送前请先读取资源。 |
| 不要自动重试;先查询资源、上传或任务是否已创建。 | 该操作会创建对象且没有幂等键,盲目重试可能产生重复。 |
| 除非端点专属文档说明安全,否则不要自动重试。 | 契约信息不足以归类该操作。按不安全对待。 |
生成覆盖:212 个操作;93 个有端点专属的已记录业务码,119 个目前依赖通用错误契约。