文档概念与架构

BEEOS CLOUD / DEVELOPER REFERENCE

运维、用量与错误

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

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

领域接口关注点
用量usage.getSummary应用范围用量与限额
Responsesresponses.get、responses.getEvents、responses.cancel终态与输出;异步工作使用 background: true
WebhookWebhook 指南投递与签名失败
错误TypeScript BeeOSAPIError;Python APIError;Go *APIErrorHTTP 状态、错误码、请求 ID

带版本的写入使用 If-Match。版本冲突时应重新读取并合并,不自动覆盖。报告故障时保留 X-Request-ID。

方法签名与错误见 API 参考。

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