fix: normalize -DiskSize and -RootFsSize before sending to PVE

Disk and rootfs size strings were interpolated directly into the disk
spec as "<storage>:<size>", so "60G" produced "local-lvm:60G". On
LVM/LVM-thin storages PVE parses the value after the colon as a volume
name unless it is a bare integer, returning "unable to parse lvm volume
name '60G'". File-backed storages mask this by accepting either form.

SizeParser.NormalizeToGibibytes() now strips G/GB/T/TB suffixes and
returns a bare GiB integer string, so the documented "32G" call shape
works on every storage type. Sub-GB units are rejected with a clear
error rather than being silently truncated.

Tracked as F086. Closes #58.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Clint Branham
2026-05-20 17:52:44 -05:00
parent f2925ba49f
commit 6181c8ce77
5 changed files with 204 additions and 6 deletions
@@ -0,0 +1,73 @@
using System;
using System.Globalization;
using System.Text.RegularExpressions;
namespace PSProxmoxVE.Core.Utilities
{
/// <summary>
/// Parses storage size strings (e.g. "32G", "1T", "60") and normalizes them
/// to a bare integer count of gibibytes for use in PVE disk specs.
/// </summary>
/// <remarks>
/// PVE accepts a size suffix on file-backed storages (NFS, directory) but parses
/// the value after the colon as a volume name on LVM-backed storages — so
/// <c>local-lvm:32G</c> fails with "unable to parse lvm volume name '32G'" while
/// <c>local-lvm:32</c> works on every storage type. Cmdlets that build disk specs
/// must normalize size inputs through this helper before joining with the storage.
/// </remarks>
public static class SizeParser
{
private static readonly Regex Pattern = new Regex(
@"^\s*(?<num>\d+)\s*(?<unit>[A-Za-z]*)\s*$",
RegexOptions.Compiled);
/// <summary>
/// Parses a size string and returns the value as a bare integer count of GiB.
/// Accepts values like "60", "60G", "60GB" (= 60), "1T", "1TB" (= 1024).
/// Sub-GB units are rejected because PVE disk allocation is GB-granular.
/// </summary>
/// <param name="value">The size string supplied by the user.</param>
/// <param name="parameterName">Parameter name used in the error message.</param>
/// <returns>The size in whole GiB as a string, suitable for direct use in disk specs.</returns>
/// <exception cref="ArgumentException">The input cannot be parsed or uses an unsupported unit.</exception>
public static string NormalizeToGibibytes(string value, string parameterName = "size")
{
if (string.IsNullOrWhiteSpace(value))
throw new ArgumentException($"{parameterName} must not be null or empty.", parameterName);
var match = Pattern.Match(value);
if (!match.Success)
throw new ArgumentException(
$"{parameterName} '{value}' is not a valid size. Expected a positive integer optionally suffixed with G, GB, T, or TB (e.g. '32G', '1T', '60').",
parameterName);
if (!long.TryParse(match.Groups["num"].Value, NumberStyles.Integer, CultureInfo.InvariantCulture, out var num) || num <= 0)
throw new ArgumentException(
$"{parameterName} '{value}' must be a positive integer.",
parameterName);
var unit = match.Groups["unit"].Value.ToUpperInvariant();
long gib;
switch (unit)
{
case "":
case "G":
case "GB":
case "GIB":
gib = num;
break;
case "T":
case "TB":
case "TIB":
gib = checked(num * 1024L);
break;
default:
throw new ArgumentException(
$"{parameterName} '{value}' uses unsupported unit '{unit}'. Use G, GB, T, or TB. Sub-GB units (M, MB, K, KB) are not supported by PVE disk allocation.",
parameterName);
}
return gib.ToString(CultureInfo.InvariantCulture);
}
}
}
@@ -6,6 +6,7 @@ using Newtonsoft.Json.Linq;
using PSProxmoxVE.Core.Client;
using PSProxmoxVE.Core.Models.Vms;
using PSProxmoxVE.Core.Services;
using PSProxmoxVE.Core.Utilities;
namespace PSProxmoxVE.Cmdlets.Containers
{
@@ -59,9 +60,13 @@ namespace PSProxmoxVE.Cmdlets.Containers
public int? Cores { get; set; }
/// <summary>
/// <para type="description">Size of the root filesystem (e.g., "8G").</para>
/// <para type="description">
/// Size of the root filesystem. Accepts a bare integer in GiB ("8") or a value
/// suffixed with G/GB/T/TB (case-insensitive); the value is normalized to a
/// bare GiB count before being sent to the API.
/// </para>
/// </summary>
[Parameter(Mandatory = false, HelpMessage = "Size of the root filesystem (e.g. 8G).")]
[Parameter(Mandatory = false, HelpMessage = "Size of the root filesystem in GiB (e.g. 8 or 8G).")]
public string? RootFsSize { get; set; }
/// <summary>
@@ -161,7 +166,10 @@ namespace PSProxmoxVE.Cmdlets.Containers
{
var rootFsValue = RootFsStorage!;
if (!string.IsNullOrEmpty(RootFsSize))
rootFsValue += $":{RootFsSize}";
{
var sizeGib = SizeParser.NormalizeToGibibytes(RootFsSize!, nameof(RootFsSize));
rootFsValue += $":{sizeGib}";
}
config["rootfs"] = rootFsValue;
}
@@ -4,6 +4,7 @@ using Newtonsoft.Json.Linq;
using PSProxmoxVE.Core.Client;
using PSProxmoxVE.Core.Models.Vms;
using PSProxmoxVE.Core.Services;
using PSProxmoxVE.Core.Utilities;
namespace PSProxmoxVE.Cmdlets.Vms
{
@@ -74,9 +75,13 @@ namespace PSProxmoxVE.Cmdlets.Vms
public string? Machine { get; set; }
/// <summary>
/// <para type="description">Size of the primary disk (e.g., "32G").</para>
/// <para type="description">
/// Size of the primary disk. Accepts a bare integer in GiB ("32") or a value
/// suffixed with G/GB/T/TB (case-insensitive); the value is normalized to a
/// bare GiB count before being sent to the API.
/// </para>
/// </summary>
[Parameter(Mandatory = false, HelpMessage = "Size of the primary disk (e.g. 32G).")]
[Parameter(Mandatory = false, HelpMessage = "Size of the primary disk in GiB (e.g. 32 or 32G).")]
public string? DiskSize { get; set; }
/// <summary>
@@ -163,7 +168,8 @@ namespace PSProxmoxVE.Cmdlets.Vms
if (!string.IsNullOrEmpty(DiskStorage) && !string.IsNullOrEmpty(DiskSize))
{
var diskValue = $"{DiskStorage}:{DiskSize}";
var sizeGib = SizeParser.NormalizeToGibibytes(DiskSize!, nameof(DiskSize));
var diskValue = $"{DiskStorage}:{sizeGib}";
if (!string.IsNullOrEmpty(DiskFormat))
diskValue += $",format={DiskFormat}";
config["virtio0"] = diskValue;