Skip to main content
本页的每个操作都位于 rest.Rest 客户端上:

获取应用

api.GetApplication(appID) 返回完整的 squarecloud.Application 记录。

应用属性

DomainCustom 是指针 —— 解引用前务必进行 nil 检查:

获取应用状态

api.GetApplicationStatus(appID) 返回实时运行状态,其值为人类可读格式
Uptime 是一个 *int64,保存以 Unix 毫秒表示的启动时间戳 —— 应用停止时为 nil

原始状态

api.GetApplicationStatusRaw(appID)?rawData=true 调用同一个 endpoint,返回数值而非格式化字符串 —— CPU/RAM 为数字,网络为 [in, out] 字节对。当你想要计算或绘图而非打印时使用它。
格式化状态便于展示("120/512MB");原始状态适用于仪表盘、告警或任何算术运算 —— 将格式化字符串解析回数字是脆弱的做法。

每个应用的摘要状态

为避免每个应用发一次请求,调用 api.GetApplicationListStatus()
CPU 和 RAM 数值仅在应用当前处于运行中时才会出现。

获取日志

api.GetApplicationLogs(appID) 返回最近的日志输出。

获取指标

api.GetApplicationMetrics(appID) 返回过去 24 小时的 CPU、RAM 和网络采样(最多 288 个点,每 5 分钟一个),类型为 []squarecloud.MetricPoint

生命周期

api.PostApplicationSignal(appID, signal) 启动、停止或重启应用。信号是 squarecloud.ApplicationSignal* 常量之一:

删除应用

DeleteApplication 会永久移除应用。除非你有 snapshot,否则数据无法恢复