用途:在自动化 Fly.io Machines API 时,替代自造的按组织限额表,改用文档化的限额进行请求节流与冲突串行化,确保批量操作安全、可重放、可核对。
主要能力:区分 create、update、start、stop、suspend、delete、wait、list、get 等操作,并判断限流是按 Machine ID 还是 app ID 计。Machine 动作按“每操作每标识每秒 1 次、短突发至 3”预算;get-Machine 为每秒 5 次、突发至 10;app 删除最多每分钟 100 次。允许独立标识并行,同一 Machine 的更新、启停、租约、删除不得重叠。
使用方式:先分类请求并编码限额,再持久化期望状态哈希、操作、目标、当前实例版本、尝试次数与确认状态;发送变更前完成记录。遇限流优先遵循提供方给出的重试时机,否则用带抖动的有界指数退避,并设置重试预算与熔断。超时或传输失败后先读取 Machine 与实例状态再决定是否重放,只有观测状态与意图一致才标记完成。认证仅在文档化的 Machines API 基址使用 bearer 头,不扩大令牌范围,重试遥测中需脱敏头部与配置密钥。
适用场景:跨多个 app 批量更新大量 Machine 的 Worker。
限制:资料未提供完整官方文档、版本号与具体错误码以外的细节;未经操作员明确批准,不得创建、部署、扩缩、重启、停止、挂起、销毁、轮换、撤销、暴露或迁移线上资源。