From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from gate001.proxmox.com (gate001.proxmox.com [IPv6:2a0f:8001:1:32::40]) by lore.proxmox.com (Postfix) with ESMTPS id 8C9C31FF0B7 for ; Fri, 13 Nov 2026 21:34:44 +0100 (CET) Received: from gate001.proxmox.com (localhost.localdomain [127.0.0.1]) by gate001.proxmox.com (Proxmox) with ESMTP id 72DF021680; Fri, 13 Nov 2026 21:34:06 +0100 (CET) From: "Max R. Carrara" To: pve-devel@lists.proxmox.com Subject: [PATCH pve-storage v5 08/19] all plugins, api: mark certain properties as advanced in plugindata() Date: Fri, 13 Nov 2026 21:33:12 +0100 Message-ID: <20261113203330.932813-9-m.carrara@proxmox.com> X-Mailer: git-send-email 2.47.3 In-Reply-To: <20261113203330.932813-1-m.carrara@proxmox.com> References: <20261113203330.932813-1-m.carrara@proxmox.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Bm-Milter-Handled: 55990f41-d878-4baa-be0a-ee34c49e34d2 X-Bm-Transport-Timestamp: 1794602027259 X-SPAM-LEVEL: Spam detection results: 0 AWL 0.293 Adjusted score from AWL reputation of From: address DMARC_MISSING 0.1 Missing DMARC policy KAM_DMARC_STATUS 0.01 Test Rule for DKIM or SPF Failure with Strict Alignment (newer systems) RCVD_IN_DNSWL_MED -2.3 Sender listed at https://www.dnswl.org/, medium trust SPF_HELO_NONE 0.001 SPF: HELO does not publish an SPF Record SPF_PASS -0.001 SPF: sender matches SPF record Message-ID-Hash: MTTEKWPR6CYCOE2TTMIYS6DTXI2G2ZIJ X-Message-ID-Hash: MTTEKWPR6CYCOE2TTMIYS6DTXI2G2ZIJ X-MailFrom: m.carrara@proxmox.com X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; loop; banned-address; emergency; member-moderation; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header CC: Alfonso Kuen , Thomas Ellmenreich , Jakob Klocker X-Mailman-Version: 3.3.10 Precedence: list List-Id: Proxmox VE development discussion List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: Add a new 'advanced-properties' hash in `plugindata()` of all plugins. For each plugin, mark every property that is used in the "Advanced" section of the create / edit panel in the UI in that hash. This results in the following properties being marked as advanced if they do appear in a given plugin's `properties()` or `options()`: - preallocation - snapshot-as-volume-chain - namespace Additionally, expose whether a property is advanced or not through a new 'x-advanced' key that is added to each plugin property schema that is returned by the `plugins/storage/plugin` endpoint. Note that the 'x-' prefix is added here because the keyword is not part of our standard JSON schema and merely serves as a UI hint. The key is always set to either 0 or 1, also for plugins without the hash. Signed-off-by: Max R. Carrara --- src/PVE/API2/Plugins/Storage/Plugin.pm | 4 ++++ src/PVE/Storage/BTRFSPlugin.pm | 3 +++ src/PVE/Storage/CIFSPlugin.pm | 4 ++++ src/PVE/Storage/CephFSPlugin.pm | 1 + src/PVE/Storage/DirPlugin.pm | 4 ++++ src/PVE/Storage/ESXiPlugin.pm | 1 + src/PVE/Storage/ISCSIDirectPlugin.pm | 1 + src/PVE/Storage/ISCSIPlugin.pm | 1 + src/PVE/Storage/LVMPlugin.pm | 3 +++ src/PVE/Storage/LvmThinPlugin.pm | 1 + src/PVE/Storage/NFSPlugin.pm | 4 ++++ src/PVE/Storage/PBSPlugin.pm | 1 + src/PVE/Storage/RBDPlugin.pm | 3 +++ src/PVE/Storage/ZFSPlugin.pm | 1 + src/PVE/Storage/ZFSPoolPlugin.pm | 1 + 15 files changed, 33 insertions(+) diff --git a/src/PVE/API2/Plugins/Storage/Plugin.pm b/src/PVE/API2/Plugins/Storage/Plugin.pm index e243ed81..360f21da 100644 --- a/src/PVE/API2/Plugins/Storage/Plugin.pm +++ b/src/PVE/API2/Plugins/Storage/Plugin.pm @@ -77,13 +77,15 @@ my sub get_schema_for_plugin : prototype($) ($plugin) { # Derive options from the initialized data instead of using `options()`, # since `init_isolated()` automatically adds properties to options that # were not specified explicitly my $pdata = $plugin->private(); my $options = $pdata->{options}->{$type}; + my $plugindata = $plugin->plugindata(); # also covers the fallback for plugins without 'sensitive-properties' in their plugindata() my $sensitive = { map { $_ => 1 } PVE::Storage::Plugin::sensitive_properties($type)->@* }; + my $advanced = $plugindata->{'advanced-properties'} // {}; my $schema = {}; for my $option (keys $options->%*) { my $prop_schema = PVE::RESTHandler::api_dump_remove_refs( @@ -95,10 +97,12 @@ my sub get_schema_for_plugin : prototype($) ($plugin) { if (!defined($property->{sensitive})) { $property->{sensitive} = $sensitive->{$option} ? 1 : 0; } + $property->{'x-advanced'} = $advanced->{$option} ? 1 : 0; + $schema->{$option} = $property; for my $opt_key (keys $options->{$option}->%*) { $property->{$opt_key} = $options->{$option}->{$opt_key}; } diff --git a/src/PVE/Storage/BTRFSPlugin.pm b/src/PVE/Storage/BTRFSPlugin.pm index 166bf815..0108e03d 100644 --- a/src/PVE/Storage/BTRFSPlugin.pm +++ b/src/PVE/Storage/BTRFSPlugin.pm @@ -43,10 +43,13 @@ sub plugindata { import => 1, }, { images => 1, rootdir => 1 }, ], format => [{ raw => 1, subvol => 1 }, 'raw'], + 'advanced-properties' => { + preallocation => 1, + }, 'sensitive-properties' => {}, }; } sub properties { diff --git a/src/PVE/Storage/CIFSPlugin.pm b/src/PVE/Storage/CIFSPlugin.pm index 23b505cd..5a04154a 100644 --- a/src/PVE/Storage/CIFSPlugin.pm +++ b/src/PVE/Storage/CIFSPlugin.pm @@ -123,10 +123,14 @@ sub plugindata { import => 1, }, { images => 1 }, ], format => [{ raw => 1, qcow2 => 1, vmdk => 1 }, 'raw'], + 'advanced-properties' => { + preallocation => 1, + 'snapshot-as-volume-chain' => 1, + }, 'sensitive-properties' => { password => 1 }, }; } sub properties { diff --git a/src/PVE/Storage/CephFSPlugin.pm b/src/PVE/Storage/CephFSPlugin.pm index fcb8a9e6..59cb57c3 100644 --- a/src/PVE/Storage/CephFSPlugin.pm +++ b/src/PVE/Storage/CephFSPlugin.pm @@ -116,10 +116,11 @@ sub type { sub plugindata { return { content => [{ vztmpl => 1, iso => 1, backup => 1, snippets => 1, import => 1 }, { backup => 1 }], + 'advanced-properties' => {}, 'sensitive-properties' => { keyring => 1 }, }; } sub properties { diff --git a/src/PVE/Storage/DirPlugin.pm b/src/PVE/Storage/DirPlugin.pm index 226f5cc3..0165d7a2 100644 --- a/src/PVE/Storage/DirPlugin.pm +++ b/src/PVE/Storage/DirPlugin.pm @@ -36,10 +36,14 @@ sub plugindata { import => 1, }, { images => 1, rootdir => 1 }, ], format => [{ raw => 1, qcow2 => 1, vmdk => 1, subvol => 1 }, 'raw'], + 'advanced-properties' => { + preallocation => 1, + 'snapshot-as-volume-chain' => 1, + }, 'sensitive-properties' => {}, }; } sub properties { diff --git a/src/PVE/Storage/ESXiPlugin.pm b/src/PVE/Storage/ESXiPlugin.pm index e0ea2837..82f64650 100644 --- a/src/PVE/Storage/ESXiPlugin.pm +++ b/src/PVE/Storage/ESXiPlugin.pm @@ -30,10 +30,11 @@ sub type { sub plugindata { return { content => [{ import => 1 }, { import => 1 }], format => [{ raw => 1, qcow2 => 1, vmdk => 1 }, 'raw'], + 'advanced-properties' => {}, 'sensitive-properties' => { password => 1 }, }; } sub properties { diff --git a/src/PVE/Storage/ISCSIDirectPlugin.pm b/src/PVE/Storage/ISCSIDirectPlugin.pm index fb732850..72bad793 100644 --- a/src/PVE/Storage/ISCSIDirectPlugin.pm +++ b/src/PVE/Storage/ISCSIDirectPlugin.pm @@ -64,10 +64,11 @@ sub type { sub plugindata { return { content => [{ images => 1, none => 1 }, { images => 1 }], select_existing => 1, + 'advanced-properties' => {}, 'sensitive-properties' => {}, }; } sub options { diff --git a/src/PVE/Storage/ISCSIPlugin.pm b/src/PVE/Storage/ISCSIPlugin.pm index 2a32d8c9..11abc639 100644 --- a/src/PVE/Storage/ISCSIPlugin.pm +++ b/src/PVE/Storage/ISCSIPlugin.pm @@ -385,10 +385,11 @@ sub type { sub plugindata { return { content => [{ images => 1, none => 1 }, { images => 1 }], select_existing => 1, + 'advanced-properties' => {}, 'sensitive-properties' => {}, }; } sub properties { diff --git a/src/PVE/Storage/LVMPlugin.pm b/src/PVE/Storage/LVMPlugin.pm index 2e74500a..b7497b72 100644 --- a/src/PVE/Storage/LVMPlugin.pm +++ b/src/PVE/Storage/LVMPlugin.pm @@ -853,10 +853,13 @@ sub type { sub plugindata { return { content => [{ images => 1, rootdir => 1 }, { images => 1 }], format => [{ raw => 1, qcow2 => 1 }, 'raw'], + 'advanced-properties' => { + 'snapshot-as-volume-chain' => 1, + }, 'sensitive-properties' => {}, }; } my $on_volume_remove_format = { diff --git a/src/PVE/Storage/LvmThinPlugin.pm b/src/PVE/Storage/LvmThinPlugin.pm index 85b071b5..f342651c 100644 --- a/src/PVE/Storage/LvmThinPlugin.pm +++ b/src/PVE/Storage/LvmThinPlugin.pm @@ -34,10 +34,11 @@ sub type { } sub plugindata { return { content => [{ images => 1, rootdir => 1 }, { images => 1, rootdir => 1 }], + 'advanced-properties' => {}, 'sensitive-properties' => {}, }; } sub properties { diff --git a/src/PVE/Storage/NFSPlugin.pm b/src/PVE/Storage/NFSPlugin.pm index e54c4a4a..85497df6 100644 --- a/src/PVE/Storage/NFSPlugin.pm +++ b/src/PVE/Storage/NFSPlugin.pm @@ -64,10 +64,14 @@ sub plugindata { import => 1, }, { images => 1 }, ], format => [{ raw => 1, qcow2 => 1, vmdk => 1 }, 'raw'], + 'advanced-properties' => { + preallocation => 1, + 'snapshot-as-volume-chain' => 1, + }, 'sensitive-properties' => {}, }; } sub properties { diff --git a/src/PVE/Storage/PBSPlugin.pm b/src/PVE/Storage/PBSPlugin.pm index d1c94653..83b6f89b 100644 --- a/src/PVE/Storage/PBSPlugin.pm +++ b/src/PVE/Storage/PBSPlugin.pm @@ -29,10 +29,11 @@ sub type { } sub plugindata { return { content => [{ backup => 1, none => 1 }, { backup => 1 }], + 'advanced-properties' => {}, 'sensitive-properties' => { 'encryption-key' => 1, 'master-pubkey' => 1, password => 1, }, diff --git a/src/PVE/Storage/RBDPlugin.pm b/src/PVE/Storage/RBDPlugin.pm index 6c62fc15..1022c8d6 100644 --- a/src/PVE/Storage/RBDPlugin.pm +++ b/src/PVE/Storage/RBDPlugin.pm @@ -414,10 +414,13 @@ sub type { } sub plugindata { return { content => [{ images => 1, rootdir => 1 }, { images => 1 }], + 'advanced-properties' => { + namespace => 1, + }, 'sensitive-properties' => { keyring => 1 }, }; } sub properties { diff --git a/src/PVE/Storage/ZFSPlugin.pm b/src/PVE/Storage/ZFSPlugin.pm index c257facd..ac8e7539 100644 --- a/src/PVE/Storage/ZFSPlugin.pm +++ b/src/PVE/Storage/ZFSPlugin.pm @@ -192,10 +192,11 @@ sub type { } sub plugindata { return { content => [{ images => 1 }, { images => 1 }], + 'advanced-properties' => {}, 'sensitive-properties' => {}, }; } sub properties { diff --git a/src/PVE/Storage/ZFSPoolPlugin.pm b/src/PVE/Storage/ZFSPoolPlugin.pm index 8b6fa0ae..522fee8b 100644 --- a/src/PVE/Storage/ZFSPoolPlugin.pm +++ b/src/PVE/Storage/ZFSPoolPlugin.pm @@ -62,10 +62,11 @@ sub type { sub plugindata { return { content => [{ images => 1, rootdir => 1 }, { images => 1, rootdir => 1 }], format => [{ raw => 1, subvol => 1 }, 'raw'], + 'advanced-properties' => {}, 'sensitive-properties' => {}, }; } sub properties { -- 2.47.3