feat(services): implement service layer for all domains

Add service classes for nodes, VMs, containers, storage, snapshots, network/SDN, users/roles/permissions, templates, cloud-init, tasks, and cluster. SDN services enforce PVE 8.0+ version guard. Task service supports polling with configurable timeout and progress callbacks. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-09-03 02:38:07 +00:00 · 2026-03-17 15:45:23 -05:00
parent 4ac38f7714
commit 52f1978de4
11 changed files with 1705 additions and 0 deletions
@@ -0,0 +1,116 @@
+using System;
+using System.Collections.Generic;
+using Newtonsoft.Json.Linq;
+using PSProxmoxVE.Core.Authentication;
+using PSProxmoxVE.Core.Client;
+using PSProxmoxVE.Core.Models.Vms;
+
+namespace PSProxmoxVE.Core.Services
+{
+    /// <summary>
+    /// Service for Proxmox VE VM snapshot API operations.
+    /// All operations apply to QEMU/KVM VMs via the /nodes/{node}/qemu/{vmid}/snapshot endpoints.
+    /// </summary>
+    public class SnapshotService
+    {
+        /// <summary>
+        /// Returns all snapshots for a VM.
+        /// </summary>
+        public PveSnapshot[] GetSnapshots(PveSession session, string node, int vmid)
+        {
+            if (session == null) throw new ArgumentNullException(nameof(session));
+            if (string.IsNullOrWhiteSpace(node)) throw new ArgumentNullException(nameof(node));
+
+            using var client = new PveHttpClient(session);
+            var response = client.GetAsync($"nodes/{node}/qemu/{vmid}/snapshot")
+                .GetAwaiter().GetResult();
+            var data = JObject.Parse(response)["data"];
+            return data?.ToObject<PveSnapshot[]>() ?? Array.Empty<PveSnapshot>();
+        }
+
+        /// <summary>
+        /// Creates a snapshot of a VM. Returns the task UPID.
+        /// </summary>
+        /// <param name="snapname">Snapshot name (alphanumeric, no spaces).</param>
+        /// <param name="description">Optional description.</param>
+        /// <param name="vmstate">Whether to save VM RAM state (live snapshot). Default false.</param>
+        public PveTask CreateSnapshot(
+            PveSession session,
+            string node,
+            int vmid,
+            string snapname,
+            string? description = null,
+            bool vmstate = false)
+        {
+            if (session == null) throw new ArgumentNullException(nameof(session));
+            if (string.IsNullOrWhiteSpace(node)) throw new ArgumentNullException(nameof(node));
+            if (string.IsNullOrWhiteSpace(snapname)) throw new ArgumentNullException(nameof(snapname));
+
+            var formData = new Dictionary<string, string>
+            {
+                ["snapname"] = snapname,
+                ["vmstate"] = vmstate ? "1" : "0"
+            };
+            if (!string.IsNullOrEmpty(description))
+                formData["description"] = description!;
+
+            using var client = new PveHttpClient(session);
+            var response = client.PostAsync($"nodes/{node}/qemu/{vmid}/snapshot", formData)
+                .GetAwaiter().GetResult();
+            return ParseTask(response, node);
+        }
+
+        /// <summary>
+        /// Removes a snapshot from a VM. Returns the task UPID.
+        /// </summary>
+        public PveTask RemoveSnapshot(
+            PveSession session,
+            string node,
+            int vmid,
+            string snapname)
+        {
+            if (session == null) throw new ArgumentNullException(nameof(session));
+            if (string.IsNullOrWhiteSpace(node)) throw new ArgumentNullException(nameof(node));
+            if (string.IsNullOrWhiteSpace(snapname)) throw new ArgumentNullException(nameof(snapname));
+
+            using var client = new PveHttpClient(session);
+            var response = client.DeleteAsync($"nodes/{node}/qemu/{vmid}/snapshot/{snapname}")
+                .GetAwaiter().GetResult();
+            return ParseTask(response, node);
+        }
+
+        /// <summary>
+        /// Rolls a VM back to a snapshot. Returns the task UPID.
+        /// </summary>
+        public PveTask RollbackSnapshot(
+            PveSession session,
+            string node,
+            int vmid,
+            string snapname)
+        {
+            if (session == null) throw new ArgumentNullException(nameof(session));
+            if (string.IsNullOrWhiteSpace(node)) throw new ArgumentNullException(nameof(node));
+            if (string.IsNullOrWhiteSpace(snapname)) throw new ArgumentNullException(nameof(snapname));
+
+            using var client = new PveHttpClient(session);
+            var response = client.PostAsync($"nodes/{node}/qemu/{vmid}/snapshot/{snapname}/rollback")
+                .GetAwaiter().GetResult();
+            return ParseTask(response, node);
+        }
+
+        // -------------------------------------------------------------------------
+        // Private helpers
+        // -------------------------------------------------------------------------
+
+        private static PveTask ParseTask(string response, string node)
+        {
+            var data = JObject.Parse(response)["data"];
+            if (data?.Type == JTokenType.String)
+                return new PveTask { Upid = data.ToString(), Node = node };
+
+            var task = data?.ToObject<PveTask>() ?? new PveTask();
+            task.Node = node;
+            return task;
+        }
+    }
+}