核心概念

​

核心概念

​

工作区 (Workspace)

工作区是 Nonce 最顶层的组织单位，矿场、矿机和配置都归属于某个工作区。

• 每个工作区都有唯一的 workspace_id（格式：org_xxxxxxxxxxxxxxxxxxxxxxxxxxx）
• API Key 仅在所属工作区内有效

​

矿场 (Farm)

矿场是矿机的物理或逻辑分组。

• 每个矿场都有唯一的 farm_id（UUID 格式）
• 矿场属于单个工作区
• 指标和 Task 都按矿场组织

​

矿机 (Miner)

矿机对应一台挖矿设备。

• 每个矿机都有唯一的 miner_id
• 矿机属于单个矿场
• 矿机数据包括算力、功耗、温度和状态等

​

Agent

Agent 是矿机和 Nonce 平台之间的通信组件。

• Agent 注册到矿场
• 一个 Agent 管理所在矿场内的多台矿机

​

Task

Task 是在矿机上执行的操作，按 Task Batch 批量创建和下发。

• 通过 API 创建的是 Task Batch，系统为每台目标矿机生成对应的 Task
• 常见 Task 包括日志收集、功耗模式调整和矿池更新

​

操作者 (Actor)

操作者（Actor）标明谁在系统里执行了操作，用来追溯资源的创建和修改。

• 三种操作者类型：user（用户）、apikey（API Key）和 system（系统）
• 用于审计和 Task Batch 溯源

---

​

通用参数

​

分页

大多数列表端点支持分页：