api: controllers: update schema of endpoints

The possible properties returned by the controller endpoints were only
partly documented. Add all missing properties and update descriptions
for existing properties.

Update the descriptions of the schemas in the plugin to provide more
detailed information about the different configuration options.

Move all duplicate properties between the GET endpoints into its own
variable, so we can reuse them.

Signed-off-by: Stefan Hanreich <s.hanreich@proxmox.com>
Reviewed-by: Dominik Csapak <d.csapak@proxmox.com>
Tested-by: Dominik Csapak <d.csapak@proxmox.com>

1 files changed, 3 insertions, 3 deletions

diff --git a/src/PVE/Network/SDN/Controllers/IsisPlugin.pm b/src/PVE/Network/SDN/Controllers/IsisPlugin.pm
index 716bb0f..3a9acfd 100644
--- a/src/PVE/Network/SDN/Controllers/IsisPlugin.pm
+++ b/src/PVE/Network/SDN/Controllers/IsisPlugin.pm
@@ -31,16 +31,16 @@ sub pve_verify_sdn_isis_net {
 sub properties {
     return {
         'isis-domain' => {
-            description => "ISIS domain.",
+            description => "Name of the IS-IS domain.",
             type => 'string',
         },
         'isis-ifaces' => {
-            description => "ISIS interface.",
+            description => "Comma-separated list of interfaces where IS-IS should be active.",
             type => 'string',
             format => 'pve-iface-list',
         },
         'isis-net' => {
-            description => "ISIS network entity title.",
+            description => "Network Entity title for this node in the IS-IS network.",
             type => 'string',
             format => 'pve-sdn-isis-net',
         },