计算资源与告警 API

计算资源为产品任务提供 Worker 容量；告警接口管理接收人、规则与通知历史。两组 API 在运维上有关联，但告警不能替代对产生告警的工作流、SQL 或来源任务状态进行检查。

计算资源生命周期

方法与路径

用途

GET /newmoi/compute-resource-specs

列出可用规格

GET /newmoi/compute-resources/worker-images

列出可选 Worker 镜像

POST /newmoi/compute-resources

创建计算资源

GET /newmoi/compute-resources

列出工作区资源

GET /newmoi/compute-resources/:id

读取单个资源

PUT /newmoi/compute-resources/:id

更新资源

GET .../:id/preflight-delete

检查删除依赖

DELETE /newmoi/compute-resources/:id

删除资源

POST .../:id/suspend

暂停容量

POST .../:id/resume

恢复容量

POST .../:id/retry

重试失败的生命周期操作

GET .../:id/metrics

读取资源指标

规格本身也有管理接口，包括创建、更新、启停和管理权限检查。这些属于管理操作；除非部署 授权契约明确允许，否则不应开放给普通工作区操作员。

创建、恢复、暂停、重试和删除可能异步执行。应保存资源 ID，并读取详情直到契约定义的 目标或终态。删除前必须调用 Preflight，并向调用者说明已绑定工作流或活动任务。部署 支持强制删除时，也必须得到明确确认。

CPU、内存、副本数、镜像和自动暂停配置只能从部署规格中选择，不能自行推断单位或编造 镜像 Tag。节点长时间排队时，应把资源状态和指标与工作流执行关联分析，不要反复创建 新容量。

/newmoi/admin/compute-resources 下的管理接口具有更大范围，需要单独授权。

告警接收人

/newmoi/alerting/receiver 接口族覆盖可用通知类型、列表 / 详情、创建、更新与删除。 Receiver 请求可能包含邮箱、Webhook 目标或其他敏感地址。启用前应验证目标和所有权， 日志中不得输出密钥。

告警规则与历史

路径

用途

/newmoi/alerting/workspace/alert/default_info/list

读取规则模板 / 默认信息

/newmoi/alerting/workspace/alert/rule/list

列出规则

/newmoi/alerting/workspace/alert/rule/create

创建规则

/newmoi/alerting/workspace/alert/rule/update

更新规则

/newmoi/alerting/workspace/alert/rule/delete

删除规则

/newmoi/alerting/history/list

列出告警历史

/newmoi/alerting/history/read/group

把一组历史标为已读

Expression ID、级别、类别、阈值、静默行为、接收人类型和通知间隔，必须来自部署 Schema 与 default-info 响应。不能自行构造表达式，也不能猜测阈值单位。

告警路由已经注册，但部分部署在前后端联调完成前会隐藏告警主菜单。手工输入 URL 能收到 响应，并不能证明生产通知已启用。依赖告警前，必须确认模块可用、投递配置完成，并成功 发送一次真实测试通知。

把历史标为已读只会改变确认状态，不会解决底层事件。诊断时应保留告警 Group / Rule ID、时间范围、工作区，以及相关执行或资源 ID。

工作流执行控制见工作流与 Lineage。

最后更新于