用途:通过 Proxmox VE 的 REST API 全面管理虚拟化环境,覆盖集群、节点、虚拟机(qemu)与 LXC 容器的日常运维操作。
主要能力:查询集群状态与节点列表及节点详情;列出节点或集群范围内的 VM 与容器;对 VM/容器执行启动、立即停止、优雅关机、重启;创建 LXC 容器与 VM;克隆 VM/容器(支持完整克隆与链接克隆);将 VM/容器转换为模板;管理快照(列出、创建、回滚、删除);执行备份(vzdump)、列出备份与还原备份;查看存储、可用模板与 ISO,并下载模板;查询与查看任务(UPID)状态和日志;删除 VM/容器,支持强制删除并清理未引用磁盘。
使用方式:先设置环境变量 PVE_URL(如 https://192.168.1.10:8006)与 PVE_TOKEN(形如 user@pam!tokenid=secret-uuid),API Token 在数据中心 → 权限 → API Tokens 中创建(取消勾选 Privilege Separation)。请求头使用 Authorization: PVEAPIToken=$PVE_TOKEN,之后用 curl 调用 /api2/json 下的对应端点;自签名证书加 -k,API Token 无需 CSRF;将 {node} 替换为节点名、{vmid} 替换为 ID,VM 用 qemu、容器用 lxc。列举节点可用 curl -sk -H "$AUTH" "$PVE_URL/api2/json/nodes" | jq。
适用场景:批量或脚本化运维 Proxmox VE 上的虚拟机与容器,例如创建实例、启停、快照、备份与还原、模板转换和资源查看。
限制:创建/克隆等操作返回任务 UPID,需另行查询任务状态确认结果;删除 VM 须先停止(或使用 purge 强制删除);资料未提供安装方式、版本要求、收费与价格信息,暂未提供。