文档平台

BEEOS CLOUD / DEVELOPER REFERENCE

运维、用量与错误

处理生命周期状态、用量限额、Webhook 投递和请求失败

实例创建与生命周期修改可能异步完成。Go 服务端 SDK 在创建、停止和删除时返回实例数据与操作。轮询 instances.getStatus 直到环境报告就绪或终态失败。重试同一意图使用稳定幂等键;不同意图使用新键。

领域接口关注点
用量usage.getSummary、getHistory、getLimits应用范围用量与限额
任务tasks.get、listMessages、cancel、continueTask终态与消息历史
WebhooktaskWebhooks.listDeliveries、redeliver、verifySignature投递与签名失败
错误TypeScript BeeOSAPIError;Go ResponseErrorHTTP 状态、错误码、请求 ID
运行时methods.getCapabilities实例支持的方法

带版本的写入使用 If-Match。版本冲突时应重新读取并合并,不自动覆盖。报告故障时保留 X-Request-ID。处理 Webhook 时,先验证准确的原始请求体,再解析 JSON,并保持处理器幂等。

控制台账单和组织限额与 SDK 的用量查询分开。价格和实时配额以当前账号、环境显示为准。