From fc6c0fddb2715230c36e0e93998dbcd64617026c Mon Sep 17 00:00:00 2001
From: Dietmar Maurer <dietmar@proxmox.com>
Date: Tue, 10 Jul 2018 11:45:05 +0200
Subject: [PATCH] PVE/API2/Cluster.pm - document return properties for cluster
 resource list.

Signed-off-by: Dietmar Maurer <dietmar@proxmox.com>
---
 PVE/API2/Cluster.pm | 75 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 75 insertions(+)

diff --git a/PVE/API2/Cluster.pm b/PVE/API2/Cluster.pm
index 2eac6b52..3c6ddbf2 100644
--- a/PVE/API2/Cluster.pm
+++ b/PVE/API2/Cluster.pm
@@ -175,6 +175,81 @@ __PACKAGE__->register_method({
 	items => {
 	    type => "object",
 	    properties => {
+		id => { type => 'string' },
+		type => {
+		    destriction => "Resource type.",
+		    type => 'string',
+		    enum => ['node', 'storage', 'pool', 'qemu', 'lxc'],
+		},
+		status => {
+		    description => "Resource type dependent status.",
+		    type => 'string',
+		    optional => 1,
+		},
+		node => get_standard_option('pve-node', {
+		    description => "The cluster node name (when type in node,storage,qemu,lxc).",
+		    optional => 1,
+		}),
+		storage => get_standard_option('pve-storage-id', {
+		    description => "The storage identifier (when type == storage).",
+		    optional => 1,
+		}),
+		pool => {
+		    description => "The pool name (when type in pool,qemu,lxc).",
+		    type => 'string',
+		    optional => 1,
+		},
+		cpu => {
+		    description => "CPU utilization (when type in node,qemu,lxc).",
+		    type => 'number',
+		    optional => 1,
+		    renderer => 'fraction_as_percentage',
+		},
+		maxcpu => {
+		    description => "Number of available CPUs (when type in node,qemu,lxc).",
+		    type => 'integer',
+		    optional => 1,
+		},
+		mem => {
+		    description => "Used memory in bytes (when type in node,qemu,lxc).",
+		    type => 'string',
+		    optional => 1,
+		    renderer => 'bytes',
+		},
+		maxmem => {
+		    description => "Number of available memory in bytes (when type in node,qemu,lxc).",
+		    type => 'integer',
+		    optional => 1,
+		    renderer => 'bytes',
+		},
+		level => {
+		    description => "Support level (when type == node).",
+		    type => 'string',
+		    optional => 1,
+		},
+		uptime => {
+		    description => "Node uptime in seconds (when type in node,qemu,lxc).",
+		    type => 'integer',
+		    optional => 1,
+		    renderer => 'duration',
+		},
+		hastate => {
+		    description => "HA service status (for HA managed VMs).",
+		    type => 'string',
+		    optional => 1,
+		},
+		disk => {
+		    description => "Used disk space in bytes (when type in storage), used root image spave for VMs (type in qemu,lxc).",
+		    type => 'string',
+		    optional => 1,
+		    renderer => 'bytes',
+		},
+		maxdisk => {
+		    description => "Storage size in bytes (when type in storage), root image size for VMs (type in qemu,lxc).",
+		    type => 'integer',
+		    optional => 1,
+		    renderer => 'bytes',
+		},
 	    },
 	},
     },