一、Proxmox API 创建 QEMU 虚拟机的必要参数 #

调用 Proxmox 的 /nodes/{node}/qemu POST 接口创建虚拟机时，以下是必填参数和高频实用参数：

• vmid：虚拟机的唯一ID，必须是集群内未被占用的整数
• ostype：操作系统类型标识，比如 l26（适配Linux 2.6+内核）、win10（Windows 10优化配置），用于Proxmox自动调整虚拟机硬件适配
• cores：虚拟机分配的CPU核心数量
• memory：虚拟机内存大小，单位为MB（例如2048代表2GB）
• scsi0：主磁盘配置，格式为{存储池名称}:{磁盘大小}，比如local-lvm:20表示在local-lvm存储池创建20GB磁盘
• net0：网络接口配置，格式为{网卡类型},bridge={网桥名称}，常用virtio,bridge=vmbr0（virtio是高性能半虚拟化网卡）
• ide2（镜像启动场景必填）：ISO镜像路径，格式为{存储池}:iso/{镜像文件名}
• boot：启动顺序配置，比如order=ide2;scsi0表示优先从ISO镜像启动，再从主磁盘启动

除此之外，还有CPU类型、PCI设备直通、防火墙规则等可选参数，可根据业务需求灵活添加。

二、你的自定义 CreateVm 函数的分析与优化建议 #

从你给出的代码片段来看，整体方向是对的，但还有几个关键细节需要完善：

1. 补全参数映射逻辑 #

目前代码还没有把VMTemplate中的字段转换为API请求参数，这是核心缺失项。你需要把模板里的配置一一映射到Proxmox API要求的参数中：

// 示例：添加核心参数
request.AddParameter("vmid", template.VmId);
request.AddParameter("cores", template.Cores);
request.AddParameter("memory", template.Memory);
request.AddParameter("scsi0", $"{template.StoragePool}:{template.DiskSize}");
request.AddParameter("net0", $"virtio,bridge={template.NetworkBridge}");

2. 处理特殊格式配置 #

如果VMTemplate包含ISO镜像、启动顺序这类需要特定格式的字段，要严格匹配Proxmox的要求：

// 示例：处理ISO镜像启动配置
if (!string.IsNullOrEmpty(template.IsoPath))
{
    request.AddParameter("ide2", template.IsoPath);
    request.AddParameter("boot", "order=ide2;scsi0");
}

3. 增加错误处理与任务校验 #

Proxmox返回的Upid是任务ID，并非创建成功的直接标志。你需要后续调用/nodes/{node}/tasks/{upid}/status接口检查任务状态，同时要处理请求异常：

try
{
    var response = client.Execute<Upid>(request);
    if (!response.IsSuccessful)
    {
        // 打印响应内容便于排查参数或权限问题
        throw new InvalidOperationException($"API请求失败: {response.StatusCode} - {response.Content}");
    }
    return response;
}
catch (HttpRequestException ex)
{
    throw new Exception("创建虚拟机时网络请求异常", ex);
}

4. 完善客户端配置 #

如果你的Proxmox集群使用自签名SSL证书，需要在RestClient中跳过证书验证，否则会请求失败：

client.RemoteCertificateValidationCallback = (sender, cert, chain, sslPolicyErrors) => true;

5. 确保认证有效性 #

你已经添加了CSRFPreventionToken和PVEAuthCookie，但要注意_apiTicket必须是未过期的有效票据。如果票据过期，请求会返回401错误，需要重新获取认证凭证。

内容的提问来源于stack exchange，提问作者Muhammad Fahad