节点计算引擎
Stash Cloud 编排独立的 rgbldkd 节点。当前公开接入契约以 V3 节点管理 为准，不需要开发者直接操作基础设施。
生命周期
- 创建：API Key 调用
POST /v3/nodes，请求体仅支持可选name（或{}），成功202。不支持节点类型或资源规格选择器。 - 查询：列表使用分页
{nodes,next_cursor}；详情包含status、public_dns、api_base_url、可选已持有的p2p_*、失败信息与资源字段。分配域名不代表就绪，也不赋予 API Key 原生接口访问权限。 - 启停：
POST /v3/nodes/{id}/start、/stop返回200和节点详情。 - P2P：
POST /v3/nodes/{id}/p2p为运行中的用户节点申请公网地址；HTTPS API 地址不是 P2P 连接地址。 - 删除：
DELETE /v3/nodes/{id}返回200的删除结果；没有公开撤销删除或备份恢复操作。 - 写操作建议主动提供稳定 UUID 并在同一操作重试时复用；Key、
X-Network与操作 scope 必须匹配。
创建是异步操作。生产环境查询状态时应设置总期限、处理失败状态并采用退避；不要承诺固定上线时间或默认配额。
下图按当前公开契约说明上述操作的状态流转。status 是服务端返回的字符串，不在此穷举；状态或幂等冲突时接口可返回 409。
运行策略与能力边界
空闲回收与按需唤醒属于服务运行策略，不是创建请求中的角色选择。不要假定所有管理请求都会延长活跃期限，或节点停止时业务请求一定成功。
API Key 只提供公开管理能力，不提供节点原生操作。保活相关产品功能不等于资金操作或交易授权。
容量目标、自动快照与异地保留策略不是公开 API 的能力承诺，应以服务约定为准。