BEEOS CLOUD / DEVELOPER REFERENCE
运维、用量与错误
处理生命周期状态、用量限额、Webhook 投递和请求失败
实例创建与生命周期修改可能异步完成。Go 服务端 SDK 在创建、停止和删除时返回实例数据与操作。轮询 instances.getStatus 直到环境报告就绪或终态失败。重试同一意图使用稳定幂等键;不同意图使用新键。
| 领域 | 接口 | 关注点 |
|---|---|---|
| 用量 | usage.getSummary、getHistory、getLimits | 应用范围用量与限额 |
| 任务 | tasks.get、listMessages、cancel、continueTask | 终态与消息历史 |
| Webhook | taskWebhooks.listDeliveries、redeliver、verifySignature | 投递与签名失败 |
| 错误 | TypeScript BeeOSAPIError;Go ResponseError | HTTP 状态、错误码、请求 ID |
| 运行时 | methods.getCapabilities | 实例支持的方法 |
带版本的写入使用 If-Match。版本冲突时应重新读取并合并,不自动覆盖。报告故障时保留 X-Request-ID。处理 Webhook 时,先验证准确的原始请求体,再解析 JSON,并保持处理器幂等。
控制台账单和组织限额与 SDK 的用量查询分开。价格和实时配额以当前账号、环境显示为准。
BeeOS Cloud返回文档首页