用途:为 Vast.ai Python SDK 集成提供模式指导,帮助选择层级合适且能保留所需控制力的客户端,明确资源标识与清理责任,避免把计费实例藏在无限制重试之后。
主要能力:一是选择客户端边界,VastAI 用于较广泛的命令行等价操作,SyncClient 用于类型化同步实例控制,AsyncClient 用于异步上下文,Serverless 用于端点推理;二是在单一边界归一化供应商响应,把字典与错误形状映射为内部结果类型,保留 offer ID、contract ID、状态、价格与原始错误码;三是将计划与变更分离,先搜索并评分 offer,不创建资源,调用 create、update、destroy 或信用操作前需要已批准的 plan 对象;四是拥有生命周期,立即持久化返回的实例 ID,施加单调截止时间,分类终态故障,把 destroy 或交接放入显式 finalizer;五是用本地假对象测试失败边界,包括 401、403、429、畸形响应、创建无 ID、就绪超时与清理失败。
使用方式:从 VAST_API_KEY 或经批准的本地配置构造客户端,不要以字面量传入密钥、序列化客户端对象,或让供应商凭据进入工作负载载荷。先用 Read 与 Grep 检查清单、配置、供应商输出与现有测试,再提出变更;Write 或 Edit 仅用于已批准的计划、实现、测试或脱敏回执。未经操作者明确批准,不得创建、更新、销毁或注资 Vast.ai 资源。
适用场景:异步作业运行器可用 AsyncClient 作为上下文管理器,在等待前记录 instance.id,到期取消,并在经测试的 finalizer 中销毁实例。
限制:仅依据资料,未提供具体包版本、价格、平台或其他未提及内容;实际使用须遵循上述审批与脱敏要求。