用途:通过 Proxmox VE 的 REST API 对集群、节点、虚拟机和 LXC 容器做完整管理,适合偏好命令行与脚本化操作的用户。
准备:先导出环境变量 PVE_URL(如 https://192.168.1.10:8006)和 PVE_TOKEN(形如 user@pam!tokenid=secret-uuid)。令牌在数据中心 → 权限 → API 令牌中创建,并取消勾选 Privilege Separation。请求头为 AUTH="Authorization: PVEAPIToken=$PVE_TOKEN"。
主要能力:查询集群状态与节点列表、节点详情;列出某节点或集群范围内的 VM 和 LXC;启停、关机(优雅)、重启;获取下一个可用 VMID;创建 VM 与 LXC 并支持内存、CPU、磁盘、网络、模板、ISO、启动顺序等参数;完整/链接克隆;转换为模板;创建、回滚、删除快照;发起备份与恢复;查看存储、模板与 ISO 并下载模板;查看任务与任务日志;删除 VM 或容器。
用法要点:命令统一使用 curl -sk(-k 用于自签名证书),GET 查询、POST 操作、DELETE 删除。VM 相关路径用 qemu,容器用 lxc。创建与克隆操作会返回任务 UPID,可据此跟踪执行状态。API 令牌不需要 CSRF 保护。占位符 {node}、{vmid}、{storage} 需替换为实际节点名(如 pve)和 ID。
限制:文档未说明具体版本兼容范围、权限最小化配置与错误处理细节,暂未提供;删除操作前需先停止对应虚拟机或容器。